Avara – Build Manifest

This repository contains the kas manifest and build orchestration for Avara, a consumer-oriented, privacy-focused, immutable Linux operating system.

It is the entry point for developers: cloning this repository and running kas is sufficient to reproduce full Avara images.

---

What this repo is

• kas configuration (kas/*.yml)
• pinned upstream layers and revisions
• build-time policy (machine, distro selection)
• reproducible entry point for CI and local builds

This repository does not contain distro logic or UI code — those live in meta-avara and meta-avara-ui.

---

Repository layout

avara-manifest/
├── kas/
│   ├── pc.yml              # genericx86-64 (QEMU / UEFI)
│   ├── rpi4.yml            # Raspberry Pi 4 (planned)
│   └── sargo.yml           # Pixel 3a / Halium (planned)
├── build/                  # build directory (gitignored)
└── README.md

---

Supported targets (current)

Target	Status
genericx86-64	✅ working (QEMU / UEFI / systemd-boot)
Raspberry Pi 4	⏳ planned
PinePhone	⏳ planned
Pixel 3a (sargo)	⏳ Halium bring-up
Volla Tablet	⏳ planned

---

Quick start

Requirements

• Linux host
• Python ≥ 3.10
• kas
• podman or docker (optional but recommended)
• KVM for QEMU acceleration

Build an image

git clone https://<forgejo>/avara/avara-manifest.git
cd avara-manifest
kas build kas/pc.yml

Enter the build environment

kas shell kas/pc.yml

Output images

Images are produced under:

build/tmp*/deploy/images/<machine>/

Typically as .wic disk images suitable for QEMU, libvirt, or flashing.

---

Design goals

• Fully reproducible builds
• Immutable / image-based system
• Clean separation of policy (Avara) vs mechanism (Yocto)
• CI-friendly (Forgejo Actions)

---

License

This repository contains only configuration and metadata.

SPDX-License-Identifier: GPL-3.0-or-later