Coolify

For Coolify, use the same two-service model from Docker Compose.

Configure the services

Configure Coolify this way:

• deploy ghcr.io/simonc602/team-os-server:beta as the memory-api service;
• do not override the image start command;
• expose only the memory-api service through Coolify's reverse proxy;
• keep Postgres private inside the Compose network;
• do not publish port 5432;
• set the health check path to /v1/health;
• store all secrets in Coolify environment variables.

Prefer expose: ["8787"] for the API service. Coolify's reverse proxy should route public traffic to the API.

Database URL

The API should connect to Postgres with the internal service name:

MEMORY_DATABASE_URL=postgres://postgres:<password>@postgres:5432/agentic_memory
PGSSLMODE=disable

Public URLs

Use the public Coolify URL for all public URL variables:

MEMORY_API_PUBLIC_URL=https://team.example.com
BETTER_AUTH_URL=https://team.example.com
TEAM_OS_PUBLIC_URL=https://team.example.com

Mount a persistent volume at /data/agentic-os. Set AGENTIC_OS_DIR to the same path.

If it points inside /app, uploaded workspace files and backup state may be lost when the container is rebuilt.

Next: Startup and first owner