Running The Server

Postgram can run in containerized environments or directly from local Node build.

What this page covers

Server startup modes and the main runtime endpoints to validate.

Core workflow

1. Docker stack (recommended):

docker compose up -d --build

2. Confirm endpoint availability:

• REST: http://127.0.0.1:3100/api
• MCP: http://127.0.0.1:3100/mcp
• Health: http://127.0.0.1:3100/health

3. Production-style local run:

npm run build
npm start

4. Verify startup health after deploy:

curl http://127.0.0.1:3100/health

Notes

• The Docker image can be pulled directly or built locally from source.
• If the service does not report healthy, check DB connectivity and migration startup logs before touching client tools.