--- name: roll-back-an-update description: Roll a Solnix machine back to the previous generation (boot environment) after a bad update. Use when an update broke something. --- # Roll back an update 1. **List generations.** `solnix-rebuild list-generations` and `beadm list`. Done when you can name the active BE (`N`), the one set for next boot (`R`), and the one you propose to return to. 2. **Confirm with the user**, naming the BE. A rollback changes what boots. 3. **Roll back.** `pfexec solnix-rebuild rollback` (activates the previous BE). Done when `beadm list` shows `R` on the chosen BE. 4. **Reboot when the user says so.** Done when `beadm list` shows `NR` on it. Data in shared datasets (home, `/nix`) is not rolled back; see `solnix/rules/be-generations-and-rollback.md`.