Skip to main content
Agate is a custom atomic desktop image built on top of Fedora Bazzite using BlueBuild. It ships as a signed container image you can rebase onto any compatible Fedora Atomic system in minutes, giving you a curated, reproducible desktop with development tools, gaming support, KDE theming, and security utilities pre-configured.

Quick Start

Rebase an existing Fedora Atomic system to Agate with a single command.

Verification

Verify image integrity using cosign before rebasing.

Build from Source

Clone the repo and build your own custom image locally.

Configuration

Understand how recipes, packages, and theming are structured.

​
What’s included

Packages

Curated RPMs and Flatpaks for development, gaming, and daily use.

Theming

Catppuccin, Kora icons, and KDE tweaks applied out of the box.

Helper Scripts

Justfile tasks for dotfiles, Nix, Spicetify, and YubiKey/LUKS.

Justfile Reference

Full reference for all available just commands.

​
Getting started

1

Check prerequisites

You need a running Fedora Atomic, Silverblue, or Bazzite system with rpm-ostree available.
2

Rebase to Agate

Run the rebase command to switch your system to the Agate image.
sudo rpm-ostree rebase ostree-unverified-registry:quay.io/fptbb/agate:latest
3

Reboot

After the rebase completes, reboot to boot into your new Agate system.
systemctl reboot
4

Verify the image (optional)

Confirm the image signature using cosign.
cosign verify --key https://os.fpt.icu/cosign.pub quay.io/fptbb/agate
Last modified on April 7, 2026