selfhost-ai: Command for Claude Code

Add New Service: $ARGUMENTS

Add a new optional service called $ARGUMENTS to the Selfhost AI project.

Naming Conventions

Derive these from $ARGUMENTS:

• SERVICE_SLUG = lowercase with hyphens, e.g., my-service
• SERVICE_SLUG_UNDERSCORE = lowercase with underscores, e.g., my_service
• SERVICE_NAME_UPPER = UPPERCASE with underscores, e.g., MY_SERVICE
• SERVICE_NAME_TITLE = Title Case, e.g., MyService

---

STEP 1: docker-compose.yml

File: docker-compose.yml

1.1 Basic Service Definition

Add service block in services: section (maintain alphabetical order):

  $ARGUMENTS:
    image: <org>/<image>:<tag>
    container_name: $ARGUMENTS
    profiles: ["$ARGUMENTS"]
    restart: unless-stopped
    logging:
      driver: "json-file"
      options:
        max-size: "1m"
        max-file: "1"
    environment:
      # Service-specific env vars
      SOME_VAR: "${SOME_VAR:-default}"
    healthcheck:
      test: ["CMD-SHELL", "wget -qO- http://localhost:<PORT>/health || exit 1"]
      interval: 30s
      timeout: 10s
      retries: 5
    # volumes:
    #   - ${SERVICE_SLUG_UNDERSCORE}_data:/data

1.2 Caddy Environment Passthrough

Add to caddy service environment: section (if externally accessible):

  caddy:
    environment:
      # ... existing vars ...
      ${SERVICE_NAME_UPPER}_HOSTNAME: "${${SERVICE_NAME_UPPER}_HOSTNAME}"
      # If using basic auth:
      ${SERVICE_NAME_UPPER}_USERNAME: "${${SERVICE_NAME_UPPER}_USERNAME}"
      ${SERVICE_NAME_UPPER}_PASSWORD_HASH: "${${SERVICE_NAME_UPPER}_PASSWORD_HASH}"

1.3 Named Volume (if persistent storage needed)

Add to top-level volumes: section:

volumes:
  # ... existing ...
  ${SERVICE_SLUG_UNDERSCORE}_data:

1.4 Service Dependencies

If service requires database/cache, add depends_on:

  $ARGUMENTS:
    depends_on:
      postgres:
        condition: service_healthy
      redis:
        condition: service_healthy

Common dependencies:

• postgres - PostgreSQL database
• redis - Redis cache/queue
• ollama - Local LLM inference
• minio - S3-compatible object storage
• clickhouse - Analytics database (for Langfuse)