Start here

Install Lyra OS

From ISO download to first boot: integrity, installation media and target disk.

TutorialDesktop GNOME · Lyra OS 16.1Documentation review: Translated from the Portuguese version reviewed on

1. Prepare the computer

2. Download and verify the ISO

Go to the website’s downloads section. Download the ISO and its matching .asc signature file from the release directory on SourceForge.

On Linux, open a terminal in the folder containing both files. Example for the Desktop 16.1 image, with the stable filename:

sha256sum LyraOS-Desktop-16.1-x86_64.iso
gpg --verify LyraOS-Desktop-16.1-x86_64.iso.asc LyraOS-Desktop-16.1-x86_64.iso

The name must match the downloaded file exactly. Continue only if the check reports OK. If there is a mismatch, download the files again. The checksum verifies integrity; the .asc signature of the ISO confirms its origin. First import the official release key (fingerprint 01B6 3EED BE6B 0791 26A0 116E FA73 53A1 31EC EFEB); the result must be a good signature from that key.

3. Write the media and boot in UEFI mode

  1. Open a disk image writing tool. In GNOME Disks, select the USB drive and use the option to restore a disk image.
  2. Select the ISO and double-check the target device before confirming. Copying the ISO file into a folder on the USB drive does not replace writing the image.
  3. Wait for the write to finish, eject the media and restart the computer.
  4. Open the firmware boot menu and select the media's UEFI entry. The key varies by manufacturer.

In a virtual machine, attach the ISO as an optical drive and enable UEFI. Secure Boot is part of the flow planned by the project; record any boot failure for investigation.

4. Follow the Lyra Installer

  1. Wait for the live session and for the Lyra Installer to open.
  2. Fill in the language, keyboard, region and account options presented by the installer.
  3. Choose the disk dedicated to the installation and review the summary, especially the target and the storage changes.
  4. Confirm only after reviewing the data. Keep the computer on until the installation completes.
  5. Restart when prompted and remove the media to boot from the installed disk.

The screens may change between releases.

5. Check the installed system

Log in with the account you created, test the network and open Vega. Follow the first steps after installation. If the installer fails, write down the step and the message before restarting; see how to report the problem.

Reference: Desktop 16.1 release notes (in Portuguese).