AOS / Docs

AOS // ANDYL OS

[Status: early preview] [License: multi-license]

AOS is an immutable Linux distribution for headless servers and edge systems. Its bootstrap toolchain, userspace, packages, system images, and tests are built from source in this repository without nixpkgs dependencies.

#Get started

  1. Install the AOS image on a machine or import it into a hypervisor.
  2. Configure the host with first-boot host.nix policy.
  3. Install and manage packages with apm.
  4. Operate the host, apply upgrades, and use the recovery guide when needed.

Check the support-status matrix before planning a deployment.

#Projects

  • AOS is the operating system, package manager, and host operating model.
  • AOS Hub hosts package registries and binary caches. It runs as a native service or as a Cloudflare Worker and exposes a web console, HTTP API, and the registry and cache protocols used by apr, apm, Git, and Nix. It is also the planned distribution point for AOS system images.
  • Crucible provides deterministic state-space exploration and debugging for unmodified QEMU guests.

#Documentation

#Contributing

Bug reports and feature proposals are welcome in GitHub Issues. Before changing packages, images, or build tooling, read the contribution requirements and maintainer guide. The contribution requirements document the employee authorization, external CLA, DCO, and license-boundary checks that apply before a change is merged. AOS is built hermetically from source; new dependencies must be added to the AOS package graph rather than imported from nixpkgs.

#Project status

AOS is under active development. Interfaces and disk formats may change before the first stable release. Public installation images, a production external-signing workflow, durable kernel updates, and complete runtime host.nix activation are not available yet.

#License

Original AOS code is generally licensed under the Apache License 2.0. The repository and its distributions also contain separately licensed components, including QEMU and its Crucible integration. GitHub's Apache-2.0 label describes that default; it does not describe every component in this multi-license repository. The licensing guide points to the authoritative component map, contribution agreement, and complete license texts.