backup: prove the off-host secret.key opens a restored database #305

closed cmc opened this on 2026-09-29 05:14 UTC · security

Discussion

cmc 2026-09-29 05:14 UTC

The 2026-09-29 restore drill (laptop, offsite restic snapshot ccd646cf) restored and verified every repository, release asset and LFS object, but could not check secrets: no copy of /etc/gitbay/secret.key was on the drill machine. gitbayd refuses to start while any sealed value does not open (7 build secrets, 62 mirror tokens, 1 push device, 1 webhook secret at the snapshot), so without that copy a restore does not come up at all until those rows are cleared by hand, losing them.

  • Confirm an off-host copy exists (password manager or the keys repository of runbook D) and that gitbayd admin secrets check opens every value of a restored database with it.
  • Consider a restore-drill --secret-key <file> that runs the same check, so the drill records it.
  • Record the result in the Admin wiki Restore drill table.
cmc 2026-09-29 15:07 UTC

The operator confirmed on 2026-09-29 that /etc/gitbay/secret.key is backed up off bay1. It was not tested against a restored database; the next quarterly drill (January) checks it with gitbayd admin secrets check on the restored copy and records the result in the Admin wiki table.

closed by cmc in commit 5c4e2fad20: wiki: off-host secret.key confirmed

2026-09-29 15:11 UTC