How to use rpm-ostree

From Pengwings
Revision as of 23:11, 10 February 2026 by Theleruby (talk | contribs)

List the current deployments and their status

rpm-ostree status

Pin and unpin deployments

Pin current booted deployment:

sudo ostree admin pin booted

Pin a specific entry based on index position:

sudo ostree admin pin 3

Unpin a specific entry based on index position:

sudo ostree admin pin --unpin 4

Search for a package

rpm-ostree search <package-name>

Show detailed info about a package

dnf info <package-name>

Layer a package (requires reboot)

sudo rpm-ostree install <package-name>

Remove a layered package (requires reboot)

sudo rpm-ostree remove <package-name>

Enable third party dnf repositories

sudo rpm-ostree install fedora-workstation-repositories
systemctl reboot
sudo dnf config-manager setopt updates-archive.enabled=0
sudo dnf config-manager setopt google-chrome.enabled=1
sudo dnf config-manager setopt rpmfusion-free.enabled=1
sudo dnf config-manager setopt rpmfusion-free-updates.enabled=1

Add docker repository to dnf so docker can be layered

sudo dnf config-manager addrepo --from-repofile https://download.docker.com/linux/fedora/docker-ce.repo

Temporarily create /usr overlay (lost on next boot)

sudo rpm-ostree usroverlay