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. 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 mainline builds, while semantic tags (vX.Y.Z) require release management.