Skip to content

Build your own image

Extend a published uCore image with your own Containerfile and image build workflow.

Build a derivative image from a published uCore reference. Keep your additions in a Containerfile and use a separate build and signing workflow for your image.

Start with a published image

shellContainerfile
FROM ghcr.io/ublue-os/ucore:stable

The Universal Blue image template provides a starting point for the build and signing workflow. Choose a full image reference from the supported matrix. Your derivative image has its own configuration, publishing, and signing responsibilities.

Source: uCore DIY guidance, Universal Blue image template. Checked September 18, 2026.