> ## Documentation Index
> Fetch the complete documentation index at: https://docs.studiograph.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Docker

> Run Studiograph in a container with a single persistent workspace volume.

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:

```bash theme={null}
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

```yaml theme={null}
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](/self-hosting/configuration).

<Warning>
  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](/self-hosting/storage-and-backups) for what to back up and the one-command backup bundle.
</Warning>