Docker - Studiograph

The repository ships a Dockerfile (based on node:22-slim, with git and build tools included) and a docker-compose.yml. One command brings the server up:

docker compose up -d

This runs the server on port 8000 with a named workspace volume mounted at /workspace.

First boot

The container entrypoint initializes a workspace on first boot and creates the owner account from the ADMIN_EMAIL, ADMIN_PASSWORD, and ADMIN_NAME environment variables (it runs admin user add --role owner --if-empty, so an existing owner is never overwritten). It then starts the server.

Minimal compose file

services:
  studiograph:
    build: .
    ports:
      - "8000:8000"
    volumes:
      - workspace:/workspace
    environment:
      # Owner account, created on first boot
      ADMIN_EMAIL: you@example.com
      ADMIN_PASSWORD: change-me
      ADMIN_NAME: "Your Name"
      # Workspace name
      STUDIOGRAPH_TEAM_NAME: "My Studio"
      # Identity for git commits made by the server
      GIT_USER_NAME: "Your Name"
      GIT_USER_EMAIL: you@example.com
      # Model provider key for the agent
      ANTHROPIC_API_KEY: sk-ant-...
      # Optional: additional API bearer tokens
      # API_KEYS: ...

volumes:
  workspace:

For the full list of environment variables — model providers other than Anthropic, security keys, rendering — see Configuration.

The workspace volume holds everything: your entries (the git repository), uploaded files, and the databases for accounts, file indexing, and secrets. Losing the volume without a backup means losing the workspace. See Storage & backups for what to back up and the one-command backup bundle.

Run your own instance Railway

​First boot

​Minimal compose file

First boot

Minimal compose file