Building from Source

Create custom Abora builds and contribute to development.

Development Setup

Building Abora requires a NixOS system or Nix installed on your distribution.

Quick Start

Clone the repository:

git clone https://github.com/AnimatedGTVR/Abora-OS.git

Build the ISO:

cd Abora-OS
make iso

The ISO will be in the out/ directory.

Testing in QEMU

Boot your fresh ISO in a virtual machine:

make qemu-fresh
# Boot from ISO
make qemu-disk
# Boot from installed disk

Available Make Targets

make iso

Build the Abora ISO

make release

Build full release bundle with all assets

make tinypm-package

Build TinyPM package

make qemu-fresh

Boot ISO in QEMU

make metadata

Refresh release metadata only

Validation

Run quality checks before building:

./scripts/check-scripts.sh
# Check all scripts
./scripts/check-desktops.sh
# Validate desktop configs

Project Structure

• flake.nix — Project declaration and dependencies

• configuration/ — System configurations

• scripts/ — Build and validation scripts

• packages/ — Custom packages

• modules/ — NixOS modules

• installer/ — Denali installer source

• docs/ — Documentation

Want to contribute? See the Contributing guide.