See the BlueBuild docs.

To rebase an existing atomic Fedora installation to the latest build:

• First rebase to the unsigned image, to get the proper signing keys and policies installed:

  sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/mecattaf/duo:latest
  

• Reboot to complete the rebase:

  systemctl reboot
  

• Then rebase to the signed image, like so:

  sudo rpm-ostree rebase ostree-image-signed:docker://ghcr.io/mecattaf/duo:latest
  

• Reboot again to complete the installation

  systemctl reboot
  

• Copy over git credentials

git config --global user.name "Thomas Mecattaf"
git config --global user.email "[email protected]"

• Authenticate to google chrome and follow instructions
• Authenticate to gh from the CLI
• Set icon and gtk theme with GTK Settings
• Authenticate to google drive and sync music library using Celeste

Click on the most recent successful build, then download the ISO artifact.
ISOs are named in DD-MM-YYYY date format for easy identification.

• Download and extract the ISO artifact from GitHub Actions
• ISO doesn't require an active internet connection during its usage (but it is recommended to have it for NTP functionality)
• Boot from the ISO and proceed with installation
• When ISO is booted, complete the following mandatory configuration:
  • Network & Host Name: Configure your WiFi connection if needed
  • Installation Destination: Select target disk, choose "Storage Configuration" → Automatic, then "Free up space by removing or shrinking existing partitions"
    • When "Reclaim disk space" screen appears, click "Delete all" and "Reclaim space"
  • User Creation: Input your full name, username, and password. Click Done.
  • Root Password: Set a root password for system administration (recommended for Sway environments)
• Optionally configure "Keyboard", "Language Support", "Time & Date", etc.
• Click "Begin Installation"
• After installation completes, reboot and enjoy your new Zen Linux system

After first boot, your Sway environment will be ready to use with all configured dotfiles and packages. The system will automatically apply your chezmoi configuration, so your personalized environment should be available within a few minutes of first login.

• We also make sure to add python packages install through uv, add to justfile:

uv tool install --force --python python3.12 aider-chat@latest

If a flatpak is broken, revert versions using:

flatpak list
flatpak remote-info --log flathub com.google.Chrome
flatpak update --commit=<commit-of-working-version> com.google.Chrome

View the list of available builds by entering:

skopeo list-tags docker://ghcr.io/mecattaf/duo | sort -rV

Rebasing to a specific build requires users to open a host terminal and enter:

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/IMAGE-NAME:VERSION-YEARMONTHDAY

Example:

rpm-ostree rebase ostree-image-signed:docker://ghcr.io/ublue-os/bazzite-deck:39-20240113

For the Jan. 13th 2024 bazzite-deck (Fedora 39) build.

sudo rpm-ostree rebase fedora:fedora/40/x86_64/silverblue