Update

VidArch stores SQLite, cookies and media under data/ and downloads/. Back those directories up before every update. Never run docker compose down -v as part of a normal update.

Record a GHCR image

docker compose images
docker image inspect --format '{{.RepoDigests}}' ghcr.io/lucas-lepajollec/vidarch:latest

Keep that digest or the sha-<full-commit> tag. That is the rollback target.

Published image (docker-compose.yml)

docker compose pull
docker compose up -d
docker compose logs --tail 100 vidarch

Check /api/health, the library, and an authorized test download.

To roll back:

Change the Compose image: line, then recreate:

image: ghcr.io/lucas-lepajollec/vidarch:sha-<full-commit>

docker compose up -d

Do not recreate a v1.0.0 tag to recover an old instance.

Local build

git pull --ff-only
docker compose -f docker-compose.yml -f docker-compose.build.yml up -d --build

The default Compose file pulls the published image. The explicit build override replaces it with vidarch:local for a source checkout.

From sources

Update the chosen branch, run npm ci at the root and in client/, then rebuild the application. Node.js 22.x is required.

yt-dlp

The System & yt-dlp page displays the version and allows a manual update. The automatic weekly update can be disabled. After an update, test a search and a download before considering the operation complete.