// docs

praxis docs

shell-first linux distro that owns its entire stack: kernel, static BusyBox userspace, initramfs, Limine bootloader, install flow, and docs.

core principles

  • every layer inspectable in the source tree
  • no host binaries enter the live image unless explicitly enabled
  • explicit, gated install stages (no hidden automation)
  • local documentation inside the image and installed system
  • shell-first live environment (no menu, no wizard)

what's included

  • live iso build with make targets
  • shell-first live environment with praxis-owned tools
  • three-stage install process (rootfs, initramfs, chroot)
  • desktop profiles and software bundles
  • qemu workflows (live boot, install test, smoke check)
  • branded system info with praxis-fetch
  • complete docs available offline in the image

repository structure

  • boot/ - init script, limine.conf templates
  • config/ - distro metadata, package manifests, desktop/bundle definitions
  • kernel/ - kernel config and bzImage build
  • userspace/ - static BusyBox source and build
  • rootfs/ - base filesystem skeleton
  • installer/ - praxis-install, mkinitrd, praxis-chroot, targetcheck, preflight
  • scripts/ - build pipeline, qemu workflows, validation helpers
  • Documentation/ - operator guides and reference
  • pax/ - praxis domain-specific language and examples

build and test

  • build - makefile targets and build pipeline
  • qemu - vm workflows for testing and install validation

installation and operation

  • install - three-stage install process and manual setup
  • commands - praxis-install, mkinitrd, praxis-chroot, targetcheck reference
  • packages - desktop profiles and software bundles
  • first boot - verification and system checks
  • troubleshooting - common issues and solutions

customization

  • pax - praxis configuration language for system intent

local docs: /usr/share/doc/praxis (live environment and installed system)