/wayblue

uBlue-based images for wayland compositors

Primary LanguageShellApache License 2.0Apache-2.0

Notice: These images are all in an alpha state, use at your own risk.

wayblue

secureblue

This repo takes the uBlue base starting point and builds out minimally-opinionated images for the following wayland compositors

  • wayfire (with wf-shell)
  • hyprland (with waybar)
  • sway (with waybar)
  • river (with waybar)

What

Changes and decisions in the images:

  • Set saner SDDM defaults
  • Set saner wf-shell defaults
  • Set saner waybar defaults (coming soon)
  • Add a reasonable suite of tools that are needed to have a working desktop with a wayland compositor
  • Build in a minimally opinionated config for each compositor and tools that works out of the box

Why

Fedora and uBlue provide excellent base images and tooling for immutable image building. Aside from sway however, there aren't images available for wayland compositors. This repo aims to provide those images and provide them with sane defaults.

For more info on uBlue, check out the uBlue homepage and the main uBlue repo

Installation

Warning This is an experimental feature and should not be used in production, try it in a VM for a while!

Available Images

  • wayfire
  • wayfire-nvidia
  • sway
  • sway-nvidia
  • hyprland
  • hyprland-nvidia
  • river (coming soon)
  • river-nvidia (coming soon)

Rebasing

To rebase an existing Silverblue/Kinoite installation to the latest build:

  • First rebase to the unsigned image, to get the proper signing keys and policies installed:
    rpm-ostree rebase ostree-unverified-registry:ghcr.io/wayblueorg/$IMAGE_NAME:latest
    
  • Reboot to complete the rebase:
    systemctl reboot
    
  • Then rebase to the signed image, like so:
    rpm-ostree rebase ostree-image-signed:docker://ghcr.io/wayblueorg/$IMAGE_NAME:latest
    
  • Reboot again to complete the installation
    systemctl reboot
    

Post-install

After installation, yafti will open. Make sure to follow the steps listed carefully and read the directions closely.

Nvidia

If you are using an nvidia image, run this after installation:

rpm-ostree kargs \
    --append=rd.driver.blacklist=nouveau \
    --append=modprobe.blacklist=nouveau \
    --append=nvidia-drm.modeset=1

Contributing

Follow the contributing documentation, and make sure to respect the CoC.

Development

For local Development building locally is the recommended approach.