Saphira Linux Console Menu Guide

Saphira Linux

Saphira Linux has a home of its own

Saphira Linux is AKADATA’s source-built, musl/OpenRC server distribution for self-hosted infrastructure. Development, downloads, documentation, packages and the Dragon feature sets now live on the dedicated Saphira Linux website.

Visit Saphira Linux saphira.vm2.uk

Interactive controller

Open the console interface with `./build.sh menu`

The controller uses whiptail dialogs for its build menus and Linux ncurses menuconfig for kernel configuration. Build, image, and boot actions remain independent, and cancelling a menu returns without inventing a successful build result.

./build.sh menu
./build.sh stage2-menuconfig

The figures below show each interactive screen as CSS-rendered terminal art, matching the current controller code.

Saphira Linux build control

Build, image, and boot actions are independent.

settingsConfigure global build and kernel policy

stage0Accepted cross-SDK Stage0 boundary

stage1Bootstrap rootfs

stage2Native final-system and boot packages

stage3Image package units

stage4Managed server packages

select-allSelect every package in every stage

cleanClean one unit, stage, base, or everything

rebuildRebuild one unit, stage, base, or everything

systemUsers, passwords, hostname and networking

imageBuild or validate the qcow2 image

bootBoot the qcow2 through its installed GRUB

rescueExternal kernel rescue; bypasses OpenRC and passwords

overviewShow combined status for all stages

buildBuild selected packages only

validateValidate selected packages only

nextBuild the next ready package

exitExit

Saphira Linux build controlGlobal entry point for settings, Stage0–Stage4, cleaning, rebuilding, system configuration, image, boot, rescue, overview, selected builds, validation, and next-ready execution.

Akadata build settings

Configure deterministic global build policy.

jobsSet maximum parallel jobs

loadSet maximum system load

architectureSelect the target CPU baseline

optimizationSelect compiler optimisation

pipeEnable or disable -pipe

gcc-branch-costEnable GCC 52cd026 generic branch-cost patch

profileApply the conservative or performance parallelism profile

cflagsShow target CFLAGS and CXXFLAGS

hostflagsShow host-tool compiler flags

kernelSelect default or custom kernel configuration

showShow complete effective build policy

resetRestore documented Akadata defaults

backReturn to the top-level menu

Akadata build settingsJobs, load, CPU baseline, optimisation, pipe, optional GCC branch-cost patch, profiles, compiler flags, kernel policy, effective policy, and reset.

Stage2 packages

Select, inspect, and build only Stage2 units.

statusShow this stage's package status

selectSelect packages in this stage

select-allSelect every package in this stage

buildBuild selected packages from this stage

validateValidate selected packages from this stage

nextBuild this stage's next ready package

cleanClean this stage and invalidate downstream outputs

rebuildClean, rebuild, and validate this stage

clearClear this stage's selections

backReturn to the top-level menu

Stage0–Stage3 package pagesShared status, selection, build, validation, next-ready, clean, rebuild, clear-selection, and back workflow for a selected stage.

Stage4 package selection

Space toggles packages; Enter saves this stage.

[X]stage4:acl — POSIX ACL utilities

[X]stage4:attr — Extended-attribute utilities

[X]stage4:ca-certificates — Common CA certificate store

[X]stage4:chrony — NTP client and server

[ ]stage4:clamav — Anti-virus engine

[X]stage4:curl — URL transfer library and tool

[X]stage4:dhcpcd — DHCP client

[X]stage4:dnsmasq — DNS forwarder and DHCP server

[ ]stage4:dovecot — IMAP and POP3 server

[ ]stage4:freeradius — RADIUS authentication server

[X]stage4:glib — Core application library

[X]stage4:gnupg — GNU Privacy Guard

[X]stage4:haproxy — TCP/HTTP load balancer

[X]stage4:htop — Interactive process viewer

[X]stage4:iproute2 — IP routing utilities

[X]stage4:mariadb — SQL server and client

[X]stage4:nginx — HTTP and reverse-proxy server

[X]stage4:openssh — Secure shell client and server

[ ]stage4:openvswitch — Virtual switch

[X]stage4:php85 — PHP 8.5 CLI and FPM

Stage package selectionChecklist showing package state and descriptions; Space toggles entries and Enter replaces that stage's persisted selection.

Stage4 managed server packages

Build, install, repository, image, and boot are explicit.

statusShow Stage4 package status

selectSelect Stage4 packages

select-allSelect every Stage4 package

create-keysCreate the APK repository signing key

validate-keysValidate APK and OpenPGP signing identities

preflightAudit the selected package-build environment

buildBuild selected Stage4 packages only

installInstall selected packages into the derived rootfs

validateRun Stage4 validation

repositoryCreate and sign the Akadata repository index

imageExplicitly create akadata-stage4.qcow2

cleanClean Stage4 while preserving keys and base outputs

rebuildClean and rebuild the complete Stage4 layer

bootExplicitly boot akadata-stage4.qcow2

backReturn to the top-level menu

Stage4 managed server packagesExplicit package selection, key management, preflight, build, install, validation, repository, image, clean, rebuild, and boot controls.

Stage4 package selection

Select a complete profile or choose individual packages.

akadata-stage4-baseBase package engine and runtime libraries

akadata-stage4-networkBase plus managed networking

akadata-stage4-serverFirst usable managed server profile

akadata-stage4-buildServer plus development tools

packagesChoose individual Stage4 packages

backReturn to the Stage4 menu

Stage4 package selectionNamed base, network, server, and development profiles, plus individual package selection.

System configuration

Configure independent system settings.

rootSet the root password

userCreate or update an optional user

disableuserDisable optional-user creation

hostnameSet the hostname

networkConfigure IPv4 and IPv6

backReturn to the previous menu

System configurationIndependent root account, optional user, hostname, IPv4, and IPv6 settings written through the controlled system configuration flow.

Stage4 status

┌─ Status ────────────────────────────────────────────────────────┐
│ Package                        State       Dependencies         │
├────────────────────────────────────────────────────────────────┤
│ stage0:binutils-host           completed   —                   │
│ stage0:gcc-pass1-host          completed   stage0:binutils-host│
│ stage0:musl-headers            completed   stage0:gcc-pass1-host│
│ stage0:gcc-pass2-host          completed   stage0:musl-headers │
│ stage0:musl                    completed   stage0:gcc-pass2-host│
│ stage0:gcc-final-host          completed   stage0:musl         │
│   SDK accepted · sdk.complete ✓                               │
│────────────────────────────────────────────────────────────────│
│ stage1:musl-host               completed   stage0:gcc-final-host│
│ stage1:binutils-target         completed   stage1:musl-host    │
│ stage1:gcc-target              completed   stage1:binutils-targ│
│   Stage1 rootfs · ready                                       │
│────────────────────────────────────────────────────────────────│
│ stage2:kernel-headers          completed   —                   │
│ stage2:ncurses                 completed   —                   │
│ stage2:binutils-final          completed   stage2:kernel-header│
│ stage2:gcc-final               completed   stage2:binutils-fina│
│ stage2:musl-final              completed   stage2:gcc-final    │
│ stage2:kernel-config           completed   stage2:musl-final   │
│ stage2:kernel                  completed   stage2:kernel-config│
│   Stage2 rootfs · ready                                       │
│────────────────────────────────────────────────────────────────│
│ stage4:acl                     completed   —                   │
│ stage4:nginx                   ready      stage4:openssl       │
│ stage4:php85                   blocked    stage4:oniguruma     │
│ stage4:mariadb                 ready      stage4:zlib          │
│────────────────────────────────────────────────────────────────│
│ 133 total · 89 completed · 28 ready · 16 blocked              │
└────────────────────────────────────────────────────────────────┘

Combined and per-stage statusScrollable package state report used by the overview and stage status actions.

Linux/x86 7.1.5 Kernel Configuration

Arrow keys navigate the menu. <Enter> selects submenus --->. Highlighted letters are hotkeys. Pressing <Y> includes, <N> excludes, <M> modularizes features. Press <Esc><Esc> to exit, <?> for Help, </> for Search.

Arrow keys navigate the menu.

--->General setup

_[*]Compile also drivers tested only

_[*]Kernel .config support

--->Processor type and features

--->Power management and ACPI options

[*]Bus options (PCI etc.)

--->Executable file formats

Akadata‑enabled features (from q35 fragment):

[*]64-bit kernel

[*]Symmetric multi-processing support

[*]KVM Guest support

[*]Virtio drivers

[*]Ext4 filesystem

[*]Netfilter / nftables

[*]IP virtual server support

[*]Serial 8250 console

[*]Virtio console

--->Device Drivers

--->File systems

--->Security options

--->Cryptographic API

--->Library routines

Linux kernel menuconfigThe native ncurses kernel configuration screen opened explicitly through ./build.sh stage2-menuconfig.

Saphira Linux has a home of its own

Open the console interface with ./build.sh menu

Open the console interface with `./build.sh menu`