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.example.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:

export VIDARCH_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 (docker-compose.yml)

git pull --ff-only
docker compose up -d --build

docker compose pull does nothing useful here: the service builds vidarch:local.

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.