Skip to content
Postgram

Running The Server

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

What this page covers

Section titled “What this page covers”

Server startup modes and the main runtime endpoints to validate.

Core workflow

Section titled “Core workflow”
  1. Docker stack (recommended):
Terminal window
docker compose up -d --build
  1. 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
  1. Production-style local run:
Terminal window
npm run build
npm start
  1. Verify startup health after deploy:
Terminal window
curl http://127.0.0.1:3100/health

Notes

Section titled “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.
  • Healthy HTTP and PostgreSQL status do not prove that the embedding provider is reachable. Use a scoped write, pgm queue, and search to verify enrichment.