Documentation

Astral Version 5.1.0.0
Updated March 2026
Status WIP

Everything you need to build, manage, and break Astaraxia. Pick a section below.

Components

Component Description Status
Astral 10k+ line POSIX sh package manager - install, remove, sync, build, service management active
Horizon Three-stage LFS bootstrap engine - builds a complete system from a host Linux env active
Recipes (.stars) Package recipe format - v1, v2, v3 with build hooks, dependency separation, git sources active

Quick Reference

Common Astral Commands

CommandDescription
astral -S <pkg>Install from AOHARU
astral -SA <pkg>Install from ASURA overlay
astral -R <pkg>Remove package
astral -r <pkg>Remove with orphaned deps
astral -UUpdate all packages
astral -Ss <query>Search repositories
astral -ll <pkg>List installed files
astral --rollbackRollback last transaction

Repositories

AOHARU - Axia Official Hosted Astral Repository for Users. The curated, GPG-signed official package index served via GitHub Pages.

ASURA - Astaraxia User Repository For All. Community overlay. Packages are user-contributed; dependencies are resolved from AOHARU.

Docs are a work in progress. If something is missing or wrong, open an issue on GitHub.