Stockage

VidArch sépare l'état applicatif des médias volumineux.

data/

Ce répertoire contient la base SQLite, les cookies optionnels, le secret de session et les ressources mises en cache. Il est indispensable à une restauration cohérente.

downloads/

Ce répertoire contient les vidéos, miniatures et métadonnées téléchargées. Sa taille dépend directement de la durée et de la qualité des vidéos.

Recommandations

• utilisez des montages persistants ;
• surveillez l'espace libre avant d'activer les téléchargements automatiques ;
• sauvegardez data/ et downloads/ au même instant ;
• ne montez pas ces dossiers depuis un partage instable ;
• évitez toute synchronisation qui pourrait modifier la base pendant son utilisation.

Permissions des bind mounts

L'image publiée s'exécute avec l'identité non-root 1000:1000. Un dossier hôte monté dans /app/data ou /app/downloads doit donc être lisible et modifiable par l'UID 1000. Vérifiez d'abord l'état actuel :

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

Pour les dossiers par défaut réservés à VidArch, créez-les et attribuez le propriétaire attendu avant le premier démarrage :

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

Pour une médiathèque existante et partagée, les ACL POSIX donnent l'accès à VidArch sans remplacer son propriétaire actuel :

sudo setfacl -R -m u:1000:rwX /chemin/vers/la-mediatheque
sudo setfacl -m d:u:1000:rwx /chemin/vers/la-mediatheque

Utilisez ensuite le chemin hôte absolu dans Compose :

volumes:
  - ./data:/app/data
  - /chemin/vers/la-mediatheque:/app/downloads

Vérifiez les droits effectifs après le démarrage :

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

Si setfacl n'est pas disponible sous Debian ou Ubuntu, installez le paquet acl. Évitez chmod 777 : il donne l'écriture à tous les comptes et conteneurs locaux au lieu de la réserver à l'identité qui en a besoin.

La page Paramètres → Stockage & fichiers affiche l'espace utilisé et permet de purger le cache éphémère sans supprimer les archives.