🔄 Updates and Rebuilds

Use this page to apply changes to an installed workstation.

📦 System Updates

Automatic background upgrades are intentionally disabled so your system remains completely predictable. When you are ready to update your packages to their latest versions, you update the flake.lock file.

First, update the lockfile to fetch the latest revisions of your inputs (like nixpkgs):

nix flake update

The AI command-line tools Gemini, Codex, Claude, and OpenCode use the separately pinned nixpkgs-unstable input. Update only those tools without changing the main system package set:

nix flake update nixpkgs-unstable

Finally, apply the update to your live system:

just switch

🏗️ Applying Local Changes

If you've made modifications to your local repository (e.g., added a new package in your Nix modules), follow these steps to build and apply the new configuration.

nix flake update

It is highly recommended to build and test the configuration before switching to it. This validates your syntax and logic without touching your running system:

just workstation-gui build

just workstation-gui test

Once the tests pass, apply the new configuration to your system. This makes the changes live and creates a new bootable generation:

just switch

(Note: If you encounter issues after switching, you can easily roll back to the previous generation via GRUB or the rollback command).