# Census-server

## compose.yml
```yaml
---
services:
  census-server:
    image: ghcr.io/selfhosters-cc/container-census:latest
    container_name: census-server
    restart: unless-stopped
    group_add:
      - "${DOCKER_GID:-999}"

    ports:
      - "8080:8080"

    volumes:
      # Docker socket for scanning local containers
      - /var/run/docker.sock:/var/run/docker.sock

      # Persistent data directory (database, settings, scans)
      - ./census/server:/app/data

    environment:
      # Server Configuration (optional, defaults shown)
      # SERVER_HOST: "0.0.0.0"
      # SERVER_PORT: "8080"
      # DATABASE_PATH: "./data/census.db"

      # Authentication (optional, disabled by default)
      # AUTH_ENABLED: "false"
      # AUTH_USERNAME: "your_username"
      # AUTH_PASSWORD: "your_secure_password"
      # SESSION_SECRET: "change-me-in-production"  # Required if AUTH_ENABLED=true

      # Timezone for telemetry reporting
      TZ: ${TZ:-UTC}

    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:8080/api/health"]
      interval: 30s
      timeout: 3s
      retries: 3
      start_period: 10s
```