Almacenamiento

VidArch separa el estado de la aplicación de los medios voluminosos.

data/

Este directorio contiene la base de datos SQLite, las cookies opcionales, la clave de sesión y los recursos en caché. Es indispensable para una restauración coherente.

downloads/

Este directorio contiene los vídeos, las miniaturas y los metadatos descargados. Su tamaño depende directamente de la duración y de la calidad de los vídeos.

Recomendaciones

• utilice montajes persistentes;
• supervise el espacio libre antes de activar las descargas automáticas;
• realice copias de seguridad de data/ y downloads/ en el mismo instante;
• no monte estos directorios desde una compartición inestable;
• evite cualquier sincronización que pueda modificar la base de datos durante su uso.

Permisos de los bind mounts

La imagen publicada se ejecuta con la identidad sin privilegios 1000:1000. Por tanto, un directorio del host montado en /app/data o /app/downloads debe ser legible y escribible por el UID 1000. Comprueba primero el estado actual:

stat -c '%u:%g %A %n' ./data ./downloads

Para los directorios predeterminados dedicados a VidArch, créalos y asigna el propietario esperado antes del primer inicio:

mkdir -p ./data ./downloads
sudo chown -R 1000:1000 ./data ./downloads

Para una biblioteca multimedia existente y compartida, las ACL POSIX dan acceso a VidArch sin sustituir su propietario actual:

sudo setfacl -R -m u:1000:rwX /ruta/a/la-biblioteca
sudo setfacl -m d:u:1000:rwx /ruta/a/la-biblioteca

Después, utiliza la ruta absoluta del host en Compose:

volumes:
  - ./data:/app/data
  - /ruta/a/la-biblioteca:/app/downloads

Comprueba el permiso efectivo tras iniciar el servicio:

docker compose exec vidarch sh -c 'id && test -w /app/data && test -w /app/downloads && echo writable'

Si setfacl no está disponible en Debian o Ubuntu, instala el paquete acl. Evita chmod 777: concede escritura a todas las cuentas y contenedores locales en vez de limitarla a la identidad que la necesita.

La página Configuración → Almacenamiento y archivos muestra el espacio utilizado y permite purgar la caché efímera sin eliminar los archivos.