# /opt/stacks/localai/docker-compose.yml

services:

  localai:
    container_name: localai
    image: localai/localai:latest-aio-cpu
    restart: unless-stopped
    ports:
      - "8080:8080"              # API LocalAI (només local → via Nginx)
    environment:
      TZ: Europe/Madrid
      # Configuració de rendiment (prefix LOCALAI_ obligatori)
      LOCALAI_THREADS: 4                   # Fils de CPU a usar
      LOCALAI_CONTEXT_SIZE: 4096           # Context màxim en tokens
      LOCALAI_MODELS_PATH: /models         # Path dels models GGUF
      # Logs i telemetria
      LOCALAI_LOG_LEVEL: info
      LOCALAI_DISABLE_USAGE_STATS: true
      # Opcionals recomanats
      LOCALAI_PARALLEL_REQUESTS: true      # Permet múltiples peticions simultànies
      LOCALAI_SINGLE_ACTIVE_BACKEND: true  # Allibera memòria quan es canvia de model
    volumes:
      - localai_models:/models             # Models GGUF persistents
      - localai_config:/etc/localai        # Configuració de models YAML
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/readyz"]
      interval: 30s
      timeout: 10s
      retries: 5
      start_period: 120s                   # LocalAI triga a arrencar la 1a vegada
    networks:
      - shared_net

volumes:
  localai_models:
  localai_config:

networks:
  shared_net:
    external: true
    name: shared_net