TheDocumentation Index
Fetch the complete documentation index at: https://mintlify.com/AnimatedGTVR/abora-os/llms.txt
Use this file to discover all available pages before exploring further.
abora command is the distro-layer management tool for installed Abora systems. It provides a single entry point for health checks, recovery, desktop switching, app management, configuration changes, updates, and diagnostics. All abora subcommands delegate to dedicated scripts installed under /etc/abora/, so running abora doctor is equivalent to running abora-doctor directly.
abora commands only work on a fully installed Abora system. They are not
available on the live ISO, with the exception of abora-installer, which is
part of the installation flow itself.Normal Installed Workflow
After installation, most day-to-day operations follow this sequence. Use it as your starting point whenever you want to verify system state or apply updates.Subcommand Reference
abora welcome
First-boot welcome screen and quick-action launcher. Shows system state and
offers shortcuts for common first-run tasks.
abora doctor
Full health check of the installed system. Checks flake config, Flatpak,
themes, boot assets, the update channel, the desktop profile, and ANIX.
abora check-full
Collects a full diagnostic snapshot covering ANIX, TinyPM, desktop, driver,
and Nix logs. Useful when investigating a problem in detail.
abora recovery
Interactive rollback, repair, and diagnostics menu. Offers generation
rollback, Flathub repair, config rebuild, and log collection in one place.
abora desktop
View available desktop profiles or switch the active one. Changing the
desktop triggers a rebuild through the ANIX/Abora layer.
abora apps
Install curated app bundles and browse the Abora app catalog. Wraps TinyPM
and Flatpak in a guided flow.
abora config
View or edit installed-system settings without touching Nix files by hand.
Covers hostname, timezone, desktop, and more.
abora update
Update Abora. Called internally by
sudo nixos update. Syncs the latest
Abora files into /etc/nixos/abora/ and triggers a rebuild.abora hardware-test
Run hardware readiness checks. Verifies that critical hardware components
are recognised and working correctly.
abora support-report
Collect a compressed support diagnostics archive that can be shared when
reporting issues.
Command Details
abora welcome — first-boot welcome and quick actions
abora welcome — first-boot welcome and quick actions
abora welcome presents a first-boot status screen and offers shortcuts to common setup actions. Run it immediately after a fresh install to orient yourself on the system.abora doctor — check system health
abora doctor — check system health
abora doctor is the primary health-check command. It runs a sequence of checks and reports pass, warn, or fail for each one.abora-doctor.sh):Abora scripts
Confirms that required
/etc/abora/ scripts are present: update.sh,
theme-sync.sh, support-report.sh, and anix.sh.Desktop profile
Reads the desktop setting from
abora-local.nix and checks it against the
list of supported Abora profiles.abora check-full — collect full diagnostic logs
abora check-full — collect full diagnostic logs
abora check-full collects a comprehensive diagnostic snapshot. Unlike abora doctor, which checks health interactively, check-full is oriented toward gathering log output from all subsystems — ANIX, TinyPM, desktop, drivers, and Nix — in one pass.abora recovery — rollback, repair, and diagnostics menu
abora recovery — rollback, repair, and diagnostics menu
abora desktop — view or switch desktop profiles
abora desktop — view or switch desktop profiles
abora desktop lets you inspect available desktop profiles and switch between them. After switching, the system needs to be rebuilt.abora apps — app bundle and catalog helpers
abora apps — app bundle and catalog helpers
abora apps wraps TinyPM and Flatpak to provide access to Abora’s curated app bundles. Six bundles are available at install time: Fan Favorites, Essentials, Social, Creator, Developer, and Gaming.abora config — view or edit installed-system settings
abora config — view or edit installed-system settings
abora config lets you read and change common installed-system values without editing Nix files directly. The user and disk keys are read-only through this command for safety.anix set instead. See the Configuration page for the full config reference.abora update — update Abora
abora update — update Abora
abora update is the update helper used internally by sudo nixos update. It resolves the selected Abora channel, syncs the latest project files into /etc/nixos/abora/, updates the local flake, and triggers a rebuild.abora hardware-test — run hardware readiness checks
abora hardware-test — run hardware readiness checks
abora hardware-test runs hardware readiness checks and reports on detected components.abora support-report — collect support diagnostics archive
abora support-report — collect support diagnostics archive
abora support-report collects a compressed archive of diagnostics that you can attach when reporting an issue. Run abora doctor first to understand the problem, then use this to create a shareable report.Health Check Summary
The table below maps eachabora doctor check to the file or condition it evaluates.
| Check | What is verified |
|---|---|
flake.nix exists | /etc/nixos/flake.nix is present |
abora-local.nix exists | /etc/nixos/abora-local.nix is present |
Abora update tool exists | /etc/abora/update.sh is present |
Abora theme sync exists | /etc/abora/theme-sync.sh is present |
Abora support report exists | /etc/abora/support-report.sh is present |
ANIX script exists | /etc/abora/anix.sh is present |
Bootloader theme exists | /etc/abora/bootloader/theme.txt is present |
Plymouth theme exists | /etc/abora/plymouth/abora.plymouth is present |
Flathub system remote | flatpak remotes --system includes flathub |
Update channel | Channel file contains stable or unstable |
Desktop profile | Desktop value in abora-local.nix is a recognised profile |
ANIX doctor | anix doctor exits without failures |