Deployment

AgentShip is designed for production from day one — the same make docker-setup you use locally produces a production-ready container with PostgreSQL sessions, observability, and health checks included.

Supported Platforms

  • Docker — make docker-setup, runs anywhere

  • Heroku — make heroku-deploy, one command with PostgreSQL addon

  • Cloud Run / AWS ECS — coming soon (the Docker image works today)

Deployment Checklist

  • [ ] Set at least one LLM API key (OPENAI_API_KEY, ANTHROPIC_API_KEY, or GOOGLE_API_KEY)

  • [ ] Set AGENT_SESSION_STORE_URI (PostgreSQL connection string)

  • [ ] Set AGENT_SHORT_TERM_MEMORY=Database for persistent sessions

  • [ ] Set LOG_LEVEL=INFO and ENVIRONMENT=production

  • [ ] Verify health check: GET /health

Environment Variables

Variable

Required

Description

OPENAI_API_KEY

One of these

LLM provider key

ANTHROPIC_API_KEY

One of these

LLM provider key

GOOGLE_API_KEY

One of these

LLM provider key

AGENT_SESSION_STORE_URI

Yes (production)

PostgreSQL URI

AGENT_SHORT_TERM_MEMORY

No

Database or InMemory

AGENTSHIP_AUTH_DB_URI

For OAuth MCP

PostgreSQL URI for OAuth tokens

See Configuration for the full list.

Health Check

curl http://your-deployment-url/health

Returns memory usage and status. Target: under 512 MB.

Observability

Opik tracing is built in — enable it with environment variables. No code changes needed:

  • Request/response tracing for every agent call

  • Tool call timeline and latency (visible in AgentShip Studio)

  • Token usage tracking per request

Ports

Service

Port

API / Swagger / Studio

7001

PostgreSQL (Docker host)

5433

PostgreSQL (container internal)

5432