AthenaOS Install guide

Downloads

These files are served from the AthenaOS APT/download endpoint. The APT repository remains the source of truth for CLI upgrades; VM images are provided for desktop testing.

v0.3.6 public preview Desktop VM testing

AthenaOS Desktop VM

Use the QEMU disk plus the seed ISO together in UTM/QEMU on macOS. For a physical Windows dual boot test, use the bootable installer ISO.

curl -LO https://apt.athena-os.org/downloads/athenaos-desktop-qemu-latest-amd64.qcow2
curl -LO https://apt.athena-os.org/downloads/athenaos-desktop-seed-latest-amd64.iso
curl -LO https://apt.athena-os.org/downloads/athenaos-installer-latest-amd64.iso

Desktop VM Images

QEMU / UTM disk athenaos-desktop-qemu-latest-amd64.qcow2 Latest AMD64 QCOW2 disk · use with seed ISO versioned 0.3.5 file

Desktop seed ISO athenaos-desktop-seed-latest-amd64.iso Required for first boot provisioning versioned 0.3.5 file

VirtualBox VDI athenaos-desktop-virtualbox-latest-amd64.vdi Optional VirtualBox disk image versioned 0.3.5 file

Bootable installer ISO athenaos-installer-latest-amd64.iso For USB installer and Windows dual boot testing versioned 0.3.5 file

For UTM on macOS, create an emulated Linux VM with x86_64 architecture, import the QCOW2 as the disk, and attach the seed ISO as a CD/DVD drive.

WSL And Installers

Latest WSL rootfs athenaos-wsl-latest.tar.gz

Windows WSL 2 rootfs archive.

WSL install helper install-wsl.ps1

PowerShell helper that imports AthenaOS as WSL 2.

Linux/WSL APT installer install.sh

Installs or upgrades the AthenaOS CLI through APT.

macOS Lima installer install-macos.sh

Creates the lightweight AthenaOS Lima VM on macOS.

macOS Lima profile athenaos-lima.yaml

Manual Lima profile for macOS users.

APT repository apt.athena-os.org

Signed stable APT repository for AthenaOS CLI.

Download For UTM

curl -LO https://apt.athena-os.org/downloads/athenaos-desktop-qemu-latest-amd64.qcow2
curl -LO https://apt.athena-os.org/downloads/athenaos-desktop-seed-latest-amd64.iso

Download For VirtualBox

curl -LO https://apt.athena-os.org/downloads/athenaos-desktop-virtualbox-latest-amd64.vdi
curl -LO https://apt.athena-os.org/downloads/athenaos-desktop-seed-latest-amd64.iso

Download For Dual Boot

curl -LO https://apt.athena-os.org/downloads/athenaos-installer-latest-amd64.iso

Verify The Repository

curl -fsSI https://apt.athena-os.org/dists/stable/InRelease
curl -fsS https://apt.athena-os.org/dists/stable/main/binary-all/Packages