Table of Contents

🇺🇸 English 🇧🇷 Português

• Table of Contents
  • About and Features
  • Features
  • Main Menu
  • Demo
  • File Destination
  • Installation
  • Uninstallation
  • Credits and License

About

RPM-OSTree Manager is a simple and intuitive CLI tool to install/remove and manage RPM packages and deployment on Fedora Atomic systems (Silverblue, Kinoite, Bluefin, Bazzite, Aurora).

Due to the immutable base in atomic systems, layers should only be used as a last resort. Always prioritize installing packages in this order: Flatpak, containers, and finally layers (rpm-ostree).

Features

• 📦 Install Local RPM: Scans for RPM packages in the Downloads folder and lists them numerically, or you can drag an RPM directly into the program window to install it from any location.
• 🗑️ Remove Local and Layered RPMs: Lists user-installed packages numerically for easy uninstall.
• ↩️ Rollback: Quickly revert the system to a previously selected state.
• 📌 Pin/Unpin Deployment: Pin a stable deployment to prevent being removed during updates. It will remain in the GRUB entry until you unpin it.
• ⚓ Switch Default Deployment: Set any deployment as default (including pinned ones). This "anchors" your system to a specific version for future updates.
• ☑️ Status: Check for layered packages, pending deployments and active system versioning.

💡 Information: A deployment is the complete system image (base + layered packages) listed in rpm-ostree status, identified by an index (example: 0). Pinning it prevents automatic removal.

Main Menu

Demonstration

Brief Overview Demo

demo_v2.mp4

Installing local RPM Demo

demo_install_local_rpm.mp4

These demonstrations shows only a portion of the features in action.

File Destination

This map shows where each file is placed on your system after running the installer:

Destination Path

├── /usr/local/bin/rom                                  # Main executable (from rom.sh)
├── ~/.local/share/icons/rpm-ostree-manager.svg         # Icon file (from icon.svg)
└── ~/.local/share/applications/rpm-ostree-manager.desktop # Application Menu shortcut

Installation

Run the following command to install or update RPM-OSTree Manager:

curl -fsSL https://raw.githubusercontent.com/diogopessoa/rpm-ostree-manager/main/install.sh | bash

All done! Once the installation is successful, you can find RPM-OSTree Manager in your application menu or simply type rom in your terminal.

Uninstallation

If you want to uninstall RPM-OSTree Manager, run the command:

sudo rm /usr/local/bin/rom && rm ~/.local/share/applications/rpm-ostree-manager.desktop ~/.local/share/icons/rpm-ostree-manager.svg && echo "RPM-OSTree Manager has been successfully uninstalled."

Credits and License

• License: MIT.
• Icon: The icon used is part of the Kora Icons project.
• Fedora Docs: Fedora Atomic Desktops User Guide Updates, Upgrades & Rollbacks