Bootc Manager is a simple and intuitive command-line tool for Bootc. It offers a user-friendly command line interface with management and maintenance options for Fedora Atomic and derivative systems.
- Dual-Backend Support: Native support for
bootc(Fedora Atomic 45+) with seamless fallback torpm-ostree. - System Upgrades & Rollbacks: Trigger image updates or safely roll back to a previous deployment with confirmation prompts.
- Image Switching (
bootc switch): Easily switch between desktop environments or custom OCI container images. - Layering Detection: Automatically inspects and warns about local package layering (
rpm-ostreemutations) that might conflict withbootcupdates. - Configurable of bootc-manager.conf: Allows you to configure the Bootc-Manager without complicating the standard workflow.
- Desktop Integration: Includes a
.desktopshortcut for seamless execution directly from your application launcher.
- Operating System: Fedora Atomic 44+ and derivatives (Silverblue, Kinoite, Sericea, Aurora, Bazzite, etc.).
- Core Tooling:
bootcand/orrpm-ostree.
Run the automated installer script in your terminal:
curl -fsSL https://raw.githubusercontent.com/diogopessoa/bootc-manager/main/install.sh | bash
Once installed, you can launch the application by:
- Running
bootc-managerin any terminal window, or - Searching for Bootc-Manager in your system application menu.
The bootc-manager.conf file can be used to configure Bootc-Manager without complicating the standard workflow. Can be configured in /etc/bootc-manager.conf, it will allow for options such as:
- choosing a preferred backend (bootc vs. rpm-ostree);
- enabling/disabling layering warnings;
- enable check-only
This map shows where each file is placed on your system after running the installer:
Destination Path
├── /usr/local/bin/bootc-manager # Main executable script
├── /etc/bootc-manager.conf # System-wide configuration file (optional)
├── ~/.local/share/icons/bootc-manager.svg # User application icon
└── ~/.local/share/applications/bootc-manager.desktop # Application Menu shortcut
If you wish to completely remove Bootc Manager from your system, run the following command in your terminal:
sudo rm -f /usr/local/bin/bootc-manager /usr/share/applications/bootc-manager.desktop /etc/bootc-manager.conf && \
rm -f ~/.local/share/applications/bootc-manager.desktop \
~/.local/share/icons/bootc-manager.svg && \
echo "Bootc Manager has been successfully uninstalled."- Repository: github.com/diogopessoa/bootc-manager
- Documentation & Wiki: github.com/diogopessoa/bootc-manager/wiki
- Fedora User Guide: docs.fedoraproject.org/en-US/bootc
This project is licensed under the MIT License.


