Withdrawn
Installer ISO
The installer ISO has been withdrawn and is not currently available. The published
1.8.109 image did not boot: it was built to hand the kernel off from GRUB, but the kernel
expects a UEFI handoff, so it halted immediately after "Loading MayteraOS kernel...". The
kernel also has no ISO-9660 driver and no ATAPI read path, so it cannot read a CD even
once started. That build also predated every advisory on the
security page.
Rather than leave a download that cannot work, it has been removed. A CD/ISO install path
needs real kernel support first and is tracked as a task, not a build step. In the
meantime MayteraOS installs to disk from a running system using its built-in installer.
Status Withdrawn · Blocked on ATAPI + ISO-9660 kernel support
Build from source instead
Known issue: no desktop
Bootable UEFI disk image
v2.0.2, kernel build 2285 is published and its checksums are real, but a real boot
test of the exact downloaded asset found it cannot yet reach a working desktop.
Please do not rely on it until this is fixed.
What was measured: it boots, DHCP gets a lease, and the first-boot setup wizard runs
keyboard-driven through all 8 steps and creates an account. Then login succeeds and the
desktop crashes immediately, in every one of four sessions tested, including as root:
you land back at the login screen and stay there. The fault is a NULL pixel-base
page fault inside the desktop’s icon drawing code. The direct cause: a public image
is built on a filesystem created empty on purpose, precisely so it never carries anything
copied from an internal build, and this build ships with no wallpaper or icon assets as a
result; the icon-drawing code has no guard for that case. This is the same honesty this
page already applies to the withdrawn installer ISO above: state the fault, state the
cause, do not leave a broken artifact looking fine.
A fix (shipping a free/libre asset base with the public image, and guarding the icon
lookup) is in progress, built and published behind a new automated gate: the candidate
image is booted headless and must reach a working desktop with a clean panic log before it
can ship, and that gate has to be shown rejecting this exact broken build before its result
counts for anything. This section will be rewritten with a confirmed version, file size and
checksum once a rebuilt image passes that gate, not before.
Status Published, boot-tested, desktop unreachable ·
Released v2.0.2-b2285, 2026-09-02
View the release (known issue noted)
Build from source instead
Images ship the OS, its native applications and free/libre assets only:
no third-party commercial software.
Open source
Source code
MayteraOS's own kernel and OS code is released under the GNU General Public License
v2-or-later. The userland C library is separately MIT-licensed, on purpose, so linking
against it does not impose a copyleft obligation on an application. Ported third-party
components each keep their own upstream license; see the
full license and attribution page for the complete
picture. Build it yourself with a GCC cross toolchain targeting freestanding x86-64.
License GPLv2-or-later (OS) + MIT (libc) · Kernel + userland + docs
View on GitHub
