Instalación con Docker

VidArch utiliza el puerto 2508 en el host Docker y 2508 dentro del contenedor de producción. El desarrollo desde el código fuente permanece separado en 2499 (interfaz) y 2498 (API).

Docker Compose listo para copiar

services:
  vidarch:
    image: ghcr.io/lucas-lepajollec/vidarch:latest
    ports:
      - "2508:2508"
    env_file:
      - path: .env
        required: false
    volumes:
      - ./data:/app/data
      - ./downloads:/app/downloads
    init: true
    restart: unless-stopped

Inicia y comprueba el servicio:

mkdir -p data downloads
sudo chown -R 1000:1000 data downloads
docker compose pull
docker compose up -d --force-recreate
docker compose ps

Los dos primeros comandos preparan los bind mounts de Linux para el UID/GID sin root 1000:1000 de la imagen. Docker Desktop suele gestionar por sí mismo el uso compartido de archivos del host. Para una biblioteca multimedia compartida existente, usa el método ACL de Almacenamiento; nunca uses chmod 777.

Abre http://<ip-del-servidor>:2508 desde la LAN, o http://localhost:2508 en el host Docker. No se necesita .env; el archivo opcional solo sirve para ajustes avanzados de inicio como AUTH_PASSWORD. En el primer inicio, configura una contraseña en Ajustes → Seguridad antes de hacer accesible el servicio fuera de una LAN de confianza. La imagen ya se ejecuta con el usuario node sin root e incluye su propia comprobación de salud en el puerto 2508; Compose no repite esos ajustes.

Los dos montajes son necesarios: data contiene la base de datos, sesiones, configuración y cookies; downloads contiene la biblioteca multimedia. Haz una copia de ambos con VidArch detenido.

Compilar desde el código fuente

git clone https://github.com/lucas-lepajollec/vidarch.git
cd vidarch
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

El override compila vidarch:local sin cambiar el puerto 2508 ni los directorios persistentes. No uses docker compose down -v durante una actualización normal. Consulta Primer inicio y Actualizaciones.