Skip to main content
Building Agate from source means customizing the BlueBuild recipe and building your own container image — either to test local changes or to produce a variant tailored to your own hardware. The output is a signed OCI container image derived from ghcr.io/ublue-os/bazzite-dx-nvidia:latest.
Building requires significant free disk space (several gigabytes) and a working container runtime. Make sure Podman is running and accessible before you start.

​
Required tools

You need two tools installed before you can build:
  • Podman — the container runtime used to build the image. Install it from podman.io.
  • Just — the command runner that wraps all build tasks. Install it from github.com/casey/just.
Optionally, you can install the BlueBuild CLI directly if you want to run bluebuild commands without the Justfile wrapper. The Justfile tasks use it under the hood, so having it available gives you more flexibility.

​
Setup

1

Install Podman

Follow the Podman installation guide for your distribution. On Fedora Atomic systems, Podman is already available.Confirm it works:
podman --version
2

Install Just

Install Just using your package manager or via the installer script. On Fedora:
sudo dnf install just
Or install from source using Cargo:
cargo install just
Confirm it works:
just --version
3

Clone the repository

Clone the Agate source repository and enter the project directory:
git clone git@gitlab.com:fpsys/agate.git
cd agate
4

Review the Justfile

The project uses a Justfile as its primary build interface. List available tasks to confirm your setup is working:
just --list
You should see targets including build, build-iso, build-iso-online, generate, validate, and prune.

​
Next steps

Build the image

Build the Agate container image locally from the recipe.

Build an ISO

Create a bootable ISO you can use for fresh installs on new hardware.
Last modified on April 7, 2026