Skip to content

AriCodeOS 0.11.0

Choose a tag to compare

@Lynx-Boss Lynx-Boss released this 17 Oct 20:32
· 701 commits to main since this release

AriCodeOS 0.11.0 (2026-10-17): the first version signed with the project's release key, published as a Docker image, and the one that opened the project to other people.

Website: https://www.aricodeos.org/ · Master document: AriCodeOS.md, section 94.11.

What is new

  • Update sources with a signed index (ADR 0029): update and upgrade work from updater/sources, verify an Ed25519-signed index with an anti-replay serial, plan and stage installs, and run the installer with least privilege. Verified on the laptop: versions 2 to 6 installed over the network.
  • IPC peer closed (ADR 0030): a client of a dead server learns it at once instead of waiting its full timeout; init retires the endpoints of abandoned services.
  • EHCI driver (ADR 0031): USB 2.0 root ports, hubs, boot HID keyboards and mice, bulk-only storage; the served disk is identified by GPT GUID and serial. Both controllers of the laptop ready at every boot.
  • Boot self-tests only on request (ADR 0032): the test-only programs that wrote to the owner's disk and probed the test hosts now run only with selftest.
  • Incidents closed: HID endpoint recovery and Reset Device (0001 F10/F14), SMP self-test under host load (0002), laptop link after a network update reproduced on purpose (0003), duplicated sections in updater/state repaired on read with fault events (0006). Incident 0004 (a DMA mapping that outlives its buffer) stays open.
  • Kernel base signature: a frozen SHA-512 value in the ABI, reported by the shell with l1981 and checked by the ABI tests.
  • HTTP client accepts 8 KiB of response headers (github.com sends 5.3 KiB).
  • Docker: tools/docker/Dockerfile runs the whole test suite on any machine; tools/docker/try/Dockerfile boots the system in QEMU and is published as ghcr.io/aricodelabs/aricodeos.
  • The project opened: CONTRIBUTING, SECURITY, code of conduct, GitHub templates (bug, proposal, hardware test report), official repository and website in every notice.
  • Release signing key: public half in keys/release/, fingerprint 1d3e24f3c7c753a5bcb384041ace6481736decd86345eab71e2a6ff410ad446e. This release, the USB image below and the Docker image are signed with it. 0.10.0 was signed with the development key.

Trying it

  • USB stick (aricodeos-0.11.0-usb.img.xz, attached; xz -d it first): write it to a stick you can wipe and boot a UEFI x86-64 machine with Secure Boot off; see docs/hardware.md. The internal disk is never touched. Check the file against SHA256SUMS.
  • Docker: docker run --rm -it ghcr.io/aricodelabs/aricodeos:0.11.0 boots it in QEMU with the ari> shell on your terminal (quit with Ctrl-A X).
  • QEMU from source: cargo xtask run --cmdline shell after the requirements in the README.

Known open items

Incident 0004; two xtask runs in the same checkout collide on the test runner's fixed ports; an Ethernet link drop seen once after two hours on the laptop; EHCI hubs, split transactions and 64-bit addressing only verifiable on hardware.