Skip to main content
Running just build processes recipes/recipe.yml with the BlueBuild CLI and produces a local container image based on ghcr.io/ublue-os/bazzite-dx-nvidia:latest. The resulting image appears in your local container storage and can be used immediately or pushed to a registry.
Builds can take a long time — often 20 minutes or more — because the base image is large and layers are assembled from scratch on the first run. Subsequent builds are faster due to layer caching.

​
Build steps

1

Confirm prerequisites are in place

Make sure Podman and Just are installed and the repository is cloned. See Prerequisites if you haven’t done this yet.
2

Validate the recipe (optional)

Before building, validate your recipes/recipe.yml to catch configuration errors early:
just validate
Running just validate before a build saves time — catching syntax or schema errors up front means you won’t wait through a long build only to hit a failure near the end.
3

Inspect the generated Containerfile (optional)

If you want to review the full Containerfile that BlueBuild will use before committing to a build, generate it first:
just generate
This runs bluebuild generate ./recipes/recipe.yml -o Containerfile and writes the file to the project root. You can inspect it without triggering a build.
4

Build the image

Run the build:
just build
This runs the following command under the hood:
bluebuild build ./recipes/recipe.yml
BlueBuild reads recipes/recipe.yml, resolves the base image and all configured modules, and builds the container image layer by layer via Podman.
5

Confirm the build succeeded

After the build completes, verify the image is available in local container storage:
podman images
You should see the Agate image listed with a recent creation timestamp.

​
After a successful build

Once the image is built, you can:
  • Use it locally — rebase your system onto the local image to test your changes before publishing.
  • Push to a registry — tag and push the image to a container registry (such as quay.io or ghcr.io) so others can rebase onto it.
  • Generate a bootable ISO — see Build an ISO to create installable media from the local image.

​
Cleaning up

To remove cached BlueBuild artifacts and reclaim disk space: 
just prune
This runs bluebuild prune and removes intermediate build artifacts.
Last modified on April 7, 2026