Backup And Upgrade

Everything the Face SDK keeps is on one Docker volume (face-data in the one-command install): the database, the master key that encrypts it, and the licence state.

Back Up

1. Stop the container so the database is consistent: sudo docker stop face-sdk.

2. Copy the volume to an archive:

   sudo docker run --rm -v face-data:/data -v "$PWD":/backup debian:bookworm-slim \
     tar czf /backup/face-sdk-$(date +%F).tgz -C /data .

3. Start it again: sudo docker start face-sdk.

Keep the archive as safe as the server: it holds the master key and the encrypted data together.

Restore

Create an empty volume, unpack the archive into it, and start the container with that volume. On a different machine the licence must be activated there (Demo: this counts as one of its two moves).

Upgrade

1. Back up.

2. Pull the new image and recreate the container with the same volume and settings:

   sudo docker rm -f face-sdk
   sudo docker run -d --name face-sdk ... <registry>/face-sdk:<new version>-prod-cpu

3. Check GET /v2/info for the new version.

When a release changes a recognition model, people enrolled with the old model are listed for re-enrolment and searches answer NEEDS_REENROLMENT for them. With “keep face crops” on, they can be re-enrolled without new photos.

[CONFIRM] Prod upgrade path for the Compose install (install bundle of the new version) at release.