Docker Deployment

What this page covers

How to run Postgram from the pre-built image and when to switch from local build mode.

Core workflow

1. Pull the image:

docker pull ghcr.io/ivo-toby/postgram:latest

2. Use the latest tag for the mainline build, or sha-<short> for pinning.

3. In docker-compose.yml, swap the mcp-server service from local build to image mode:

services:
  mcp-server:
    image: ghcr.io/ivo-toby/postgram:latest
    # remove build: .

4. To support native remote connectors, expose Postgram over public HTTPS and set:

OAUTH_ENABLED=true
PUBLIC_BASE_URL=https://<your-postgram-host>

The connector URL is ${PUBLIC_BASE_URL}/mcp.

5. Start the stack:

docker compose up -d

Notes

• The repository default Compose file builds locally by default; image mode is useful for quick deployment and upgrades.
• ghcr.io/ivo-toby/postgram:main maps to the same mainline build as latest. Pin sha-<short> when an immutable image reference matters; pushed v* tags also publish semantic image tags.
• If clients upload synced markdown through a reverse proxy, configure request body limits above the sync batch size. The bundled UI nginx proxy sets client_max_body_size 64m.
• See the OAuth connector guide for the full remote MCP setup.