Skip to content

awnix ISO — 2026.08.21 (x86_64)

Choose a tag to compare

View all tags
@wizzense wizzense released this 21 Aug 20:14
· 74 commits to main since this release
awnix-iso-2026.08.21
d357765

A bootable awnix image: immutable Linux with the seven aw* tools already in it, and a first-boot setup that asks three questions — all of which you can decline.

What you get

awnix-x86_64.iso — 2.68 GB, ISO 9660 with an El Torito boot record, built from Containerfile.awnix with bootc-image-builder.

Baked in: awgit awgraph awrelay awm awshare awrecover awseal. Rootless podman, buildah, skopeo, crun. Python 3.11. No services, no agent, no account.

First boot

It asks three things and every one is declinable, because "No services. No agent. No account." is the point — a setup that demanded an account to finish would contradict the thing being installed.

  1. Hostname.
  2. Components. The menu is probed, not printed from a list: it checks what is actually installable and offers only that. Anything it cannot verify is shown as unchecked rather than dropped, so being offline shrinks the menu honestly instead of silently.
  3. Link this machine to a fleet, via the OAuth device flow. Skip it and you have a complete standalone box; run awnix-setup later if you change your mind.

Re-run at any time with awnix-setup. Choices land in /etc/awnix/setup.json.

Download

GitHub caps a release asset at 2 GiB, so the image ships in two parts.

cat awnix-x86_64.iso.00.part awnix-x86_64.iso.01.part > awnix-x86_64.iso
sha256sum -c SHA256SUMS --ignore-missing
# Windows
cmd /c copy /b awnix-x86_64.iso.00.part + awnix-x86_64.iso.01.part awnix-x86_64.iso

Verify before you boot it. The install.iso line in SHA256SUMS is the reassembled image:

c5d912c9855b81acab293e953e686682c85e455ad310fe88876c9b48b4f19237

The split was checked by streaming both parts back through sha256sum and comparing to the original — byte-identical, not assumed.

Installing

Boot it on hardware or a VM; it runs the standard Anaconda installer. Being a bootc image, updates are bootc upgrade against the container image rather than a package manager, and roll back atomically.

Build it yourself

Nothing here needs this release:

podman build -t awnix-base:latest -f Containerfile.awnix .
./build-awnix-iso.sh --image localhost/awnix-base:latest

The build script refuses below 40 GB free, and it decides success from the artifact rather than the exit code — measured while producing this image, bootc-image-builder printed Build complete!, wrote a valid bootable ISO, and exited 127. It also verifies the result is genuinely bootable (CD001 at 0x8001, El Torito in sector 17), because "a file with an .iso extension exists" and "this boots" are different claims.

Known limits

  • x86_64 only. No aarch64 build yet.
  • Unbooted. The image is verified structurally — ISO 9660 magic, El Torito boot catalog, CentOS Stream 9 boot sector — and built from an image whose seven tools were confirmed to import. It has not yet been booted on real hardware. Treat that as untested rather than broken, and tell us if it fails.
  • The first-boot link step targets Aitherium's device-flow endpoint. Declining it costs you nothing else.

Apache-2.0, same as every aw* package it carries.

Assets 7
Loading