Menu
Update Bluefin system image, Flatpaks, and Homebrew packages safely.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Create, enter, and manage Distrobox containers for mutable package installation on Bluefin.
ZFS administration on Bluefin — pools, datasets, snapshots, and delivery options for an immutable host that does not ship ZFS kernel modules.
Run, build, and manage OCI containers rootlessly on Bluefin — including Quadlets for persistent systemd-managed services.
Run self-hosted services on Bluefin DX using Podman Quadlets and linuxserver.io containers — persistent, auto-updating, systemd-managed.
Install and manage CLI tools with Homebrew — the primary CLI package manager on Bluefin.
Manage GNOME extensions, gsettings, and desktop customizations on Bluefin — including which settings Bluefin owns vs. which are safe to change.
| name | updates |
| description | Update Bluefin system image, Flatpaks, and Homebrew packages safely. |
| domain | sysadmin |
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.
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 |
# Check for a pending update (non-blocking)
bootc status
# Pull latest image (runs in background, applied on next reboot)
# This happens automatically — you rarely need to run this manually.
ujust update
# See what changed in the staged image
rpm-ostree db diff
# Reboot to apply the staged update
systemctl reboot
# Roll back to the previous image (takes effect on next reboot) — preferred
bootc rollback
# Legacy/Fallback (pre-bootc systems): rpm-ostree rollback
# rpm-ostree rollback
# Or from GRUB: select the previous entry at boot
flatpak update
brew update && brew upgrade
# Show current and staged image info
bootc status --json | jq '{booted: .status.booted.image.image.image, staged: .status.staged}'
# Show last update time
rpm-ostree status
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.