homechronicle

docker run -d \
  --name homechronicle \
  --network host \
  -e WEB_PORT=3000 \
  -v hc-db:/var/lib/postgresql/data \
  -v hc-data:/app/listener/data \
  -v /run/dbus/system_bus_socket:/run/dbus/system_bus_socket:ro \
  havuq/homechronicle-standalone

# Open the dashboard
open http://localhost:3000

# No host networking? Use bridge mode instead:
# docker run -d --name homechronicle -p 3000:80 \
# -v hc-db:/var/lib/postgresql/data \
# -v hc-data:/app/listener/data \
# havuq/homechronicle-standalone

# Clone the repository
git clone https://gitlab.com/homechronicle/homechronicle.git
cd homechronicle

# Create persistent listener data directory
mkdir -p listener/data

# Copy environment config and set your secrets
cp .env.example .env
openssl rand -hex 32 # paste as API_TOKEN in .env

# Start all services (3 containers: postgres, listener, web)
docker compose up -d

# Open the dashboard
open http://localhost:3000

# Update placeholder secrets before running:
# - POSTGRES_PASSWORD
# - API_TOKEN
services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: homekit
      POSTGRES_PASSWORD: change-this-strong-password
      POSTGRES_DB: homekit_events
      TZ: UTC
    volumes:
      - postgres-data:/var/lib/postgresql/data
      - ./db/init.sql:/docker-entrypoint-initdb.d/init.sql:ro
    ports:
      - "127.0.0.1:5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U homekit -d homekit_events"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s

  listener:
    image: havuq/homechronicle-listener:latest
    restart: unless-stopped
    network_mode: host
    environment:
      DATABASE_URL: postgresql://homekit:change-this-strong-password@127.0.0.1:5432/homekit_events
      API_PORT: "3001"
      NODE_ENV: production
      API_TOKEN: replace-with-openssl-rand-hex-32
      TZ: UTC
      ALERTS_ENABLED: "false"
    volumes:
      - ./listener/data:/app/data
      - /run/dbus/system_bus_socket:/run/dbus/system_bus_socket:ro
    depends_on:
      postgres:
        condition: service_healthy

  web:
    image: havuq/homechronicle-web:latest
    restart: unless-stopped
    ports:
      - "3000:80"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      LISTENER_HOST: host.docker.internal
      LISTENER_PORT: "3001"
      API_TOKEN: replace-with-openssl-rand-hex-32
      TZ: UTC

volumes:
  postgres-data:

# Full compose options:
# https://gitlab.com/homechronicle/homechronicle/blob/main/docker-compose.yml