# KumoYami en el VPS: `docker compose up -d` (ver DESPLIEGUE.md).
# La web escucha solo en 127.0.0.1:4890 (KUMOYAMI_PORT); Caddy o Nginx delante ponen el HTTPS y los dominios de la
# Biblioteca y de Archivos (los dos al 4890). En el 4890 por IP está el inicio con los dos módulos y el panel.
#
# La imagen es pública en registry.kumoyami.com: no hace falta `docker login`. La licencia se activa en el panel
# (Licencia); sin ella el panel solo abre esa página.
services:
  web:
    # Imagen publicada de cada versión. `docker compose pull && docker compose up -d` instala la última;
    # KUMOYAMI_VERSION en el .env fija una concreta (todos los planes pueden instalar cualquiera).
    image: registry.kumoyami.com/kumoyami:${KUMOYAMI_VERSION:-latest}
    # Solo para compilar desde el código fuente (repositorio de Hostarys): descomenta y usa `docker compose up -d --build`
    # build:
    #   context: .
    #   # Las NEXT_PUBLIC_* se fijan al compilar: si cambian en el .env, hay que volver a hacer --build
    #   args:
    #     NEXT_PUBLIC_SITE_TITLE: ${NEXT_PUBLIC_SITE_TITLE:-KumoYami}
    #     # 1: con LibreOffice (unos 550 MB más), las presentaciones de las bibliotecas de Documentos se ven como páginas
    #     WITH_LIBREOFFICE: ${WITH_LIBREOFFICE:-0}
    restart: unless-stopped
    env_file: .env
    environment:
      # Tokens de OneDrive, almacenamientos del panel de admin y secreto de sesión
      DATA_DIR: /app/datos
      # El puerto de dentro del contenedor (el de la imagen; dicho aquí, también lo usan las versiones anteriores a la
      # 0.1.3, que escuchaban en el 3000, si KUMOYAMI_VERSION fija una)
      PORT: "4890"
      # Solo con NVIDIA (ver «Convertir vídeos con la GPU» más abajo)
      # NVIDIA_DRIVER_CAPABILITIES: compute,video,utility
    volumes:
      - ./datos:/app/datos
      # Carpetas del VPS para almacenamientos de tipo "Carpeta local": móntalas aquí y en el panel usa la ruta de
      # la derecha, p. ej. /data/fotos. Con :ro la web no puede modificarlas (ni subir, renombrar o borrar).
      # - /srv/fotos:/data/fotos:ro
    # 4890 para no chocar con otras apps que suelen usar el 3000; se cambia con KUMOYAMI_PORT en el .env. El 4891 (la
    # Biblioteca) y el 4892 (Archivos) son los de cada módulo para entrar sin dominio: aquí, solo por un túnel SSH. En
    # un NAS o un PC de casa, quita el 127.0.0.1: de las tres líneas para abrirlos en la red local (con el mismo número
    # a los dos lados: el inicio enlaza a cada módulo por su puerto).
    ports:
      - "127.0.0.1:${KUMOYAMI_PORT:-4890}:4890"
      - "127.0.0.1:4891:4891"
      - "127.0.0.1:4892:4892"
    # Convertir vídeos con la GPU (Apariencia → Reproducción → Aceleración por hardware). Descomenta lo de tu equipo
    # y reinicia; «Probar» en el panel dice si funciona.
    # Intel (Quick Sync) o AMD: la GPU del servidor, y el grupo dueño de /dev/dri/renderD128 para poder usarla. El
    # número sale con `ls -ln /dev/dri` (columna del grupo; p. ej. 105 en Debian/Ubuntu, 937 en Synology).
    # devices:
    #   - /dev/dri:/dev/dri
    # group_add:
    #   - "105"
    # Raspberry Pi 4 (codificador H.264 del chip; la Pi 5 no tiene): en vez de lo anterior
    # devices:
    #   - /dev/video11:/dev/video11
    # group_add:
    #   - video
    # NVIDIA (NVENC): instala en el servidor el driver y el NVIDIA Container Toolkit, descomenta
    # NVIDIA_DRIVER_CAPABILITIES en environment (arriba) y esto
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [gpu]
    labels:
      # Watchtower (abajo) solo actualiza los contenedores que lo piden
      - com.centurylinklabs.watchtower.enable=true

  # Actualizar desde el panel (Actualizaciones) con un clic. Descomenta, pon en el .env WATCHTOWER_TOKEN (una
  # contraseña larga, p. ej. `openssl rand -hex 24`) y WATCHTOWER_URL=http://watchtower:8080, y reinicia.
  # Watchtower baja la imagen pública sin iniciar sesión.
  # watchtower:
  #   image: nickfedor/watchtower
  #   restart: unless-stopped
  #   volumes:
  #     - /var/run/docker.sock:/var/run/docker.sock
  #   command: --http-api-update --label-enable --cleanup
  #   environment:
  #     WATCHTOWER_HTTP_API_TOKEN: ${WATCHTOWER_TOKEN}

  # Antivirus para lo que suben los visitantes (buzones y «Pedir archivos»). Descomenta y activa en el panel:
  # Buzones → Antivirus, servidor «clamav», puerto 3310. Usa ~1,5 GB de RAM y tarda unos minutos en arrancar la
  # primera vez mientras descarga las firmas.
  # clamav:
  #   image: clamav/clamav:stable
  #   restart: unless-stopped
  #   volumes:
  #     - ./datos/clamav:/var/lib/clamav

  # Acceso desde fuera sin abrir puertos (ver DESPLIEGUE.md, «Acceso desde fuera»). Descomenta UNA de las dos opciones.
  #
  # a) Túnel de Cloudflare con tu dominio. En Cloudflare (Zero Trust → Networks → Tunnels) crea un túnel, copia su
  #    token a CLOUDFLARE_TUNNEL_TOKEN en el .env y añade dos «Public hostnames» con servicio http://web:4890: el de
  #    Archivos (tudominio.com) y el de la Biblioteca (app.tudominio.com). Pon también CF_CONNECTING_IP_FROM=cloudflared
  #    en el .env, para que la web vea la IP real de cada visitante (fuera de casa, límites por IP, sesiones).
  # cloudflared:
  #   image: cloudflare/cloudflared:latest
  #   restart: unless-stopped
  #   command: tunnel --no-autoupdate run
  #   environment:
  #     TUNNEL_TOKEN: ${CLOUDFLARE_TUNNEL_TOKEN}
  #   depends_on:
  #     - web
  #
  # b) Tailscale: tus aparatos con Tailscale entran como si estuvieran en casa, sin abrir nada (con Funnel, también
  #    los demás). Una clave de autenticación reutilizable en TS_AUTHKEY (.env) y el archivo ./tailscale/serve.json
  #    de DESPLIEGUE.md.
  #    Cada contenedor es un nombre de tu red de Tailscale: «kumoyami» para Archivos y «kumoyami-app» para la Biblioteca
  #    (quita el segundo si no usas la Biblioteca).
  # tailscale:
  #   image: tailscale/tailscale:stable
  #   hostname: kumoyami
  #   restart: unless-stopped
  #   environment:
  #     TS_AUTHKEY: ${TS_AUTHKEY}
  #     TS_STATE_DIR: /var/lib/tailscale
  #     TS_SERVE_CONFIG: /config/serve.json
  #     TS_USERSPACE: "true"
  #   volumes:
  #     - ./tailscale/estado:/var/lib/tailscale
  #     - ./tailscale:/config:ro
  #   depends_on:
  #     - web
  # tailscale-app:
  #   image: tailscale/tailscale:stable
  #   hostname: kumoyami-app
  #   restart: unless-stopped
  #   environment:
  #     TS_AUTHKEY: ${TS_AUTHKEY}
  #     TS_STATE_DIR: /var/lib/tailscale
  #     TS_SERVE_CONFIG: /config/serve.json
  #     TS_USERSPACE: "true"
  #   volumes:
  #     - ./tailscale/estado-app:/var/lib/tailscale
  #     - ./tailscale:/config:ro
  #   depends_on:
  #     - web
