Release notes
LevitateOS 1.0 preview
Released 2026-11-18. Download it.
What it is
LevitateOS is an independent operating system. Its userland is built from Fedora 45 RPM packages. The installer, the rec* tools, A/B booting and Recipe, its package manager, are our own, and its kernel is built from pinned upstream source.
1.0 is a preview: the first public release. It is built for people who want to try it and report what they find, not yet for a computer they depend on.
What is in the ISO
- A live UEFI ISO for x86_64. It boots into the install screen: a root terminal beside the installation guide.
- The installer: the helper apps
disk-plan,base-systemandsystem-setup, or the manual toolsrecpart,recstrap,recfstabandrecsetup. - The base system: kernel, systemd, the GNU tools, the rec* tools and Recipe.
- The default software is not on the ISO. It downloads during installation, from this release's own signed parts: KDE Plasma and its apps, Firefox, audio, network, printing, fonts and the rec desktop apps. The installer checks the release's signature with the key on the ISO and each part's hash before it installs anything.
Installing
- Download the ISO, check it as shown below, and write it to a USB stick.
- Boot the computer from the stick in UEFI mode with Secure Boot disabled.
- Connect to a network. The live session runs NetworkManager. Without a network, download the release's parts beforehand and give their folder to the installer with
--parts-from DIR. - Follow the installation guide on the install screen: partition (the A/B layout is the default; mutable, one root, is an explicit choice), extract the system, write the fstab, configure the system and its boot entries.
- Reboot into the installed system. The first boot shows the login screen.
What was tested
- Everything was run in virtual machines under libvirt: the ISO build, the installed desktop booting, A/B and mutable installs, and an update from 1.0 to 1.1 through a signed channel.
- No real computer has run it yet.
Known limits
- Preview release: expect rough edges.
- x86_64 only, UEFI only, Secure Boot off (the boot files are unsigned).
- No disk encryption.
- Tested in virtual machines only. No real hardware has been tried, so Wi-Fi, graphics, suspend and laptop audio are unverified.
- Graphics on NVIDIA cards use the open nouveau driver only.
- H.264 and AAC playback need the
codecsrecipe. It is not part of the image and installing it has not been run yet. - The installer needs a network, or the release's parts downloaded beforehand, to get the default software.
Checking the ISO
The ISO is levitateos-x86_64.iso, 1.6 GiB. Its SHA-512 is:
b316699493cb18ef8ce069554b386971266142472114ac552af24a04b016247535c82f97e5cb782232fb317e1d002fa89a9165bcbff1f8d90b73629df6725678
Check the download in the folder that holds it:
echo "b316699493cb18ef8ce069554b386971266142472114ac552af24a04b016247535c82f97e5cb782232fb317e1d002fa89a9165bcbff1f8d90b73629df6725678 levitateos-x86_64.iso" | sha512sum -c - It prints levitateos-x86_64.iso: OK when the file is the one we published.
The release's own files are signed. The installer checks the signature of release.json against the public key it carries, distro/keys/release/2026-11.pub in the source repository, and then each part's hash.
Reporting problems
Open an issue at github.com/LevitateOS/LevitateOS/issues and say which release you ran, on what machine or virtual machine, and what happened. Security problems go through private reporting; SECURITY.md says how.
Licences and source
Our own code is MIT or Apache-2.0. The ISO also contains other people's software under its own licences, and the source of the GPL and LGPL programs is available. The licences page has the details and the source offer.