Updates

A versioned downloadable app/container release remains planned. The source-built Docker preview can be rebuilt while retaining the same volume. Record the current image/version, source revision, port, container name and launch settings, then make a full stopped-writer backup before changing the app.

Update a Docker installation

Review the selected source and migration notes, then use the same checkout, Compose project, .env and storage settings:

export WA_INDEXER_SOURCE_REVISION=$(git rev-parse HEAD)
docker compose -f compose.yaml -f compose.build.yaml up -d --build
docker compose ps
docker compose exec wa-indexer wa-indexer owner-link --data-dir /var/lib/wa-indexer/data

The build replaces the app image and keeps the named volume. Update and restore tests for the current Docker setup are still pending. After updating, check your saved choices, known messages, media, models, and AI connections. Keep the backup until you are satisfied the update works. Do not delete or prune volumes to perform an update.

When a versioned release becomes available, back up first, select its exact image in the release Compose file, run docker compose pull, then docker compose up -d. There is no public release image to pull today. Retain the same project/volume and do not use latest.

Native development executable

Stop the app and any service/helper using its root, back up the full root, replace the executable with the selected build and relaunch with the same data root/settings. Never run two writers or app versions on one root.

Verify and recover

Repeat owner-link for a new browser session; links expire in 30 seconds. Confirm saved choices, known search results, retained media/models/configuration and client grants. Test the exact AI client if you rely on it. Connection is separate from observed history coverage.

Treat migrations as potentially irreversible. If an update fails, stop all writers, preserve the changed volume separately and restore the full backup to a new empty volume using its recorded image/version. Do not downgrade a migrated database in place or copy only one SQLite file. Keep original and restored WhatsApp sessions stopped until you deliberately choose which one to run.