2026-04-09 19:18:15 +10:00
2026-03-24 20:12:38 +11:00
2026-03-24 20:12:38 +11:00
2026-04-09 19:18:15 +10:00
2026-03-24 20:12:38 +11:00
2026-03-25 09:54:47 +11:00
2026-03-24 20:12:38 +11:00
2026-03-25 07:48:05 +11:00

Miasma OS   bluebuild build badge

About

Miasma OS is a Fedora Atomic desktop built with love on top of a Bazzite base. It is a spin aimed at music producers and musicians utilising features found in Fedora Jam Lab, Av Linux and Ubuntu Studio but on an immutable base thanks to Bazzite and Universal blue.

Some features and packages

Windows compatibility tools for VST plugins

Audio Plugins

Virtual Instruments

DAWs, Plugin Hosts, and Sequencers

Useful Composer Tools

Additional Pre-installed Software

Custom configurations optimized for musicians

  • Start Ops kernel flag set to "performance"
  • Real-time and memlock permissions for 'audio' and 'realtime' groups (requires just script to be run on first launch)

Installation

Warning

This is an experimental feature, try at your own discretion.

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:

    rpm-ostree rebase ostree-unverified-registry:ghcr.io/tumillanino/miasma-os: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/tumillanino/miasma-os:latest
    
  • Reboot again to complete the installation

    systemctl reboot
    
  • On first launch, please open Alacritty and run the script below in order to properly configure Wine with Yabridge, Reaper paths, and system flags.

  ujust first-run

The latest tag will automatically point to the latest build. That build will still always use the Fedora version specified in recipe.yml, so you won't get accidentally updated to the next major version.

ISO

An ISO and website is coming soon ...

Verification

These images are signed with Sigstore's cosign. You can verify the signature by downloading the cosign.pub file from this repo and running the following command:

cosign verify --key cosign.pub ghcr.io/tumillanino/miasma-os
Languages
Shell 93.9%
xBase 3.1%
Ruby 1%
Python 0.8%
Lua 0.2%
Other 0.8%