Health and Logs

Health Check

curl http://127.0.0.1:2499/api/health

A successful response confirms that the HTTP process is running. It does not, by itself, prove that YouTube, yt-dlp, the disk, and each video are operational.

Docker Logs

docker compose logs --tail 200 vidarch
docker compose logs -f vidarch

Look specifically for yt-dlp errors, 403, insufficient space, permissions, SQLite database, and scanner issues.

Functional Checks

• Open the home page and settings;
• Read an existing archive;
• Check disk space;
• Start a remote search;
• Run a small authorized download;
• Confirm that the queue is progressing.

Mask cookies, private paths, and sensitive titles before sharing a log excerpt.