badblocks/ublue
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Update README

Browse source
This commit is contained in:
badblocks 2026-03-10 22:31:33 -07:00
parent 614fdd5ebe
commit de5be64557
No known key found for this signature in database
1 changed files with 10 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

21
README.md
View file

@ -1,20 +1,19 @@
# ublue-custom   [![bluebuild build badge](https://github.com/badbl0cks/bazzite-custom/actions/workflows/build.yml/badge.svg)](https://github.com/badbl0cks/bazzite-custom/actions/workflows/build.yml) # ublue-custom   [![bluebuild build badge](https://github.com/badbl0cks/ublue/actions/workflows/build.yml/badge.svg)](https://github.com/badbl0cks/ublue/actions/workflows/build.yml)
See the [BlueBuild docs](https://blue-build.org/how-to/setup/) for quick setup instructions for setting up your own repository based on this template. These are customizations of upstream Universal Blue images, which themselves are customizations of Fedora CoreOS.
After setup, it is recommended you update this README to describe your custom image.
## Installation ## Installation
> **Warning** > **Warning**
> [This is an experimental feature](https://www.fedoraproject.org/wiki/Changes/OstreeNativeContainerStable), try at your own discretion. > [This is an experimental feature](https://www.fedoraproject.org/wiki/Changes/OstreeNativeContainerStable), try at your own discretion.
First, install Bazzite normally, then rebase to this custom version! If you are not yet on an existing atomic Fedora installation, you will first need to install any existing ublue or atomic Fedora image normally (e.g. via ISO on bare metal).
Once installed, you can use that installation to complete the steps below.
To rebase an existing atomic Fedora installation to this build, including Bazzite: To rebase an existing atomic Fedora installation to this build, including any ublue-based installation:
- First rebase to the unsigned image, to get the proper signing keys and policies installed: - First rebase to the unsigned image, to get the proper signing keys and policies installed:
``` ```
rpm-ostree rebase ostree-unverified-registry:ghcr.io/badbl0cks/bazzite-badblocks-gnome:latest rpm-ostree rebase ostree-unverified-registry:ghcr.io/badbl0cks/bazzite-gnome-badblocks:latest
``` ```
- Reboot to complete the rebase: - Reboot to complete the rebase:
``` ```
@ -22,7 +21,7 @@ To rebase an existing atomic Fedora installation to this build, including Bazzit
``` ```
- Then rebase to the signed image, like so: - Then rebase to the signed image, like so:
``` ```
rpm-ostree rebase ostree-image-signed:docker://ghcr.io/badbl0cks/bazzite-badblocks-gnome:latest rpm-ostree rebase ostree-image-signed:docker://ghcr.io/badbl0cks/bazzite-gnome-badblocks:latest
``` ```
- Reboot again to complete the installation - Reboot again to complete the installation
``` ```
@ -32,8 +31,8 @@ To rebase an existing atomic Fedora installation to this build, including Bazzit
## Images ## Images
Currently the following images are available: Currently the following images are available:
- bazzite-badblocks-gnome - bazzite-gnome-badblocks (Desktop gaming)
- bazzite-badblocks-gnome-nvidia-open - ucore-hci-badblocks (Server/NAS-oriented)
## Verification ## Verification
@ -41,5 +40,5 @@ Currently the following images are available:
These images are signed with [Sigstore](https://www.sigstore.dev/)'s [cosign](https://github.com/sigstore/cosign). You can verify the signature by downloading the `cosign.pub` file from this repo and running the following command: These images are signed with [Sigstore](https://www.sigstore.dev/)'s [cosign](https://github.com/sigstore/cosign). You can verify the signature by downloading the `cosign.pub` file from this repo and running the following command:
```bash ```bash
cosign verify --key cosign.pub ghcr.io/badbl0cks/bazzite-custom cosign verify --key cosign.pub ghcr.io/badbl0cks/ublue
``` ```