docker-compose.yml

services:
  cloudcli:
    # Default to local build. Swap for `image: ghcr.io/inkarnation/cloudcli-docker:latest`.
    build:
      context: .
      args:
        PUID: ${PUID:-1000}
        PGID: ${PGID:-1000}
    image: cloudcli-docker:dev
    container_name: cloudcli
    restart: unless-stopped
    ports:
      - "${CLOUDCLI_BIND:-127.0.0.1}:${CLOUDCLI_PORT:-3001}:3001"
    environment:
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
      TZ: ${TZ:-UTC}
      # PUID/PGID are also read at runtime by the entrypoint and used to
      # remap the in-container `claude` user — set them to your host's
      # `id -u` / `id -g` to keep bind-mounted volumes writable.
      PUID: ${PUID:-1000}
      PGID: ${PGID:-1000}
    volumes:
      # Single mount captures everything the container persists:
      #   workspaces/    project trees
      #   .claude/       Claude Code sessions, plugins, MCP, skills, creds
      #   .claude.json   global Claude config / MCP server registry
      #   .cloudcli/     CloudCLI's SQLite DB (users, projects, UI prefs)
      - ./data:/home/claude