Dépannage
Résoudre les pannes les plus fréquentes de VidArch.
Le port 2499 est déjà utilisé
Arrêtez l'ancien processus ou modifiez le port publié par Docker. En développement local, vérifiez également que l'API 2498 est libre.
yt-dlp est introuvable
Contrôlez la page système, le PATH et YT_DLP_PATH. Avec Docker, recréez l'image ou le conteneur plutôt que d'installer manuellement un binaire non persistant.
YouTube renvoie 403
Mettez yt-dlp à jour, réessayez plus tard puis ajoutez des cookies uniquement si nécessaire. Vérifiez que le fichier correspond au format Netscape et n'est pas expiré.
Le téléchargement reste en attente
Vérifiez les tâches en cours, la concurrence configurée, les journaux et l'espace disque. Redémarrez proprement le service si la file ne reprend pas.
Une vidéo locale ne se lit pas
Confirmez que le fichier existe sous DOWNLOADS_DIR, que le conteneur peut le lire et que le proxy transmet les requêtes avec plage d'octets. Essayez directement via 127.0.0.1 pour isoler le proxy.
Le scanner ne trouve rien
Il est suspendu en mode local. Vérifiez aussi son activation, la fréquence, les abonnements et les journaux de la dernière analyse.
Connexion refusée après restauration
Restaurez aussi .session_secret, ou reconnectez-vous après la génération d'un nouveau secret. Si AUTH_PASSWORD vient de l'environnement, sa valeur doit correspondre à la configuration actuelle.