| name | updates |
| description | Update Bluefin system image, Flatpaks, and Homebrew packages safely. |
| domain | sysadmin |
System Updates
Bluefin is an immutable OS. Updates work differently from traditional Linux:
the base image is updated atomically via OCI pull; applications (Flatpaks, Homebrew)
update independently.
Load with: point your agent at this file.
When to Use
- Updating the system to the latest Bluefin image
- Checking if updates are available before a reboot
- Updating Flatpak apps and Homebrew packages
- Rolling back a bad update
- Understanding the update pipeline
When NOT to Use
- Modifying files in the base image — use a Distrobox or layered package instead
- CI/CD automation — use the OCI image build pipeline instead
Update Layers
Bluefin has three independent update layers:
| Layer | Tool | When Applied |
|---|
| Base OS image | bootc / rpm-ostree | On next reboot |
| Flatpak apps | flatpak update | Immediately |
| Homebrew packages | brew upgrade | Immediately |
System Image Update
bootc status
ujust update
rpm-ostree db diff
systemctl reboot
Rollback
bootc rollback
Flatpak Updates
flatpak update
Homebrew Updates
brew update && brew upgrade
Checking Update Status
bootc status --json | jq '{booted: .status.booted.image.image.image, staged: .status.staged}'
rpm-ostree status
Automatic Updates
Bluefin automatically applies image updates in the background. Flatpaks also
update automatically via a systemd timer. Manual intervention is only needed
if you want to force an update immediately or roll back.