Website: os.fpt.icu
Agate is a Fedora Bazzite-based atomic image built with BlueBuild. It is my personal daily driver, tuned for my workflow, branding, and app setup.
Warning: this image is for personal use. The source is shared for reference only, and some customizations may not fit your setup.
- Starts from
ghcr.io/ublue-os/bazzite-dx-nvidia:latest. - Keeps the system atomic and rollback-friendly.
- Adds personal branding, wallpapers, icons, cursors, and KDE tweaks.
- Enables services and tools I use often, including
nordvpnd,tailscaled,netbird,podman.socket,opensnitch, andwhatpulse. - Uses extra COPR repos for tools like
yadm,VeraCrypt, andlinuxtoys. - Ships with a curated set of RPMs and Flatpaks for development, gaming, media, and day-to-day work.
- Includes helper scripts for dotfiles, theming, development setup, YubiKey/LUKS setup, and Spotify Spicetify management.
The root Justfile provides the main build commands:
just build- build the image.just build-iso- build a local bootable ISO.just build-iso-online- build an ISO from the published image.just generate- generate aContainerfile.just validate- validate the BlueBuild recipe.just prune- prune BlueBuild artifacts.
The helper files/justfiles/*.just files add system-specific tasks:
dotfiles-*- bootstrap, sync, apply, inspect, and clean dotfiles.agate-nixpkgsandagate-devbox- install Nix and Devbox.agate-manage-themes- install Catppuccin, Kora, and PlasMusic.agate-spicetify- patch Spotify and install Spicetify Marketplace.agate-luks-setupandagate-luks-remove- manage YubiKey-backed LUKS.agate-kde-setup- configure KDE YubiKey authentication.
You can switch an existing bootc-compatible system to this custom image.
Rebase Command:
sudo rpm-ostree rebase ostree-unverified-registry:quay.io/fptbb/agate:latestor, as an alternative mirror, use Github
sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/fptbb/agate:latestAfter the command completes, reboot your system. You can check the status at any time with sudo bootc status.
To customize this image or build it yourself locally, use the provided Justfile.
- Clone the repository:
git clone git@gitlab.com:fpsys/agate.git cd agate - Build the container image:
just build
- (Optional) Build a bootable disk image:
You can create an ISO, QCOW2, or other disk image formats.
The generated images will be in the root directory.
just build-iso
These images are signed with Sigstore's cosign. You can verify the signature by downloading the cosign.pub file here and running:
cosign verify --key https://os.fpt.icu/cosign.pub quay.io/fptbb/agateMany Fedora Atomic Desktops are named after minerals and rocks—often silicates like kinoite or onyx (and even bazzite), evoking the durable, crystalline foundations of these immutable systems. In that spirit, I've named this Bazzite-based image after Red Fox Agate, a rare variety of chalcedony quartz whose vibrant orange-red bands, streaked with white, mimic the fur of a red fox.
Sourced exclusively from ancient volcanic geodes in Patagonia, Argentina (notably the Cerro Cristal region near Perito Moreno), Red Fox Agate was first discovered in 1997. Its botryoidal hematite inclusions create that signature "foxy" pattern, with a Mohs hardness of 6.5–7 making it ideal for polished cabochons, jewelry, or display specimens.
For more on this gem: Red Fox Agate Overview
This project is made possible by the work of the open-source community. Special thanks to:
- The Universal Blue project and all its contributors.
- The BlueBuild project and all its contributors.
- Inspiration from other custom OS projects like VeneOS, amyos, and m2os.
This project is licensed under the Apache License 2.0. See the LICENSE file for details.