troubleshooting

quick commands

praxis-preflight
praxis-status
praxis-disk-report
praxis-netcheck
praxis-support

target root is not mounted

if praxis-install says the target is not mounted, check:

findmnt /mnt/praxis
findmnt /mnt/praxis/boot

mount the root partition at /mnt/praxis and the efi system partition at /mnt/praxis/boot.

target check fails

praxis-target-check /mnt/praxis

that tells you whether the kernel, initramfs, loader entry, hostname, fstab, and install metadata are present.

package or desktop profile install fails

praxis-packages list
cat /mnt/praxis/etc/praxis/packages.selected
tail -n 50 /mnt/praxis/var/log/pacman.log

if the package layer fails, the two most common reasons are:

• the live environment doesn't have working network access
• the package name or desktop profile isn't valid

inspect available package sets with:

praxis-packages show desktop xfce
praxis-packages show bundle developer

network looks broken

praxis-netcheck
ip -o link show
ip -o -4 addr show

in qemu, networking problems are often vm configuration problems rather than praxis problems.

need logs or a report

praxis-support

writes a compressed bundle to /tmp with kernel messages, block-device state, network info, release files, and praxis metadata.

next: pax - the praxis configuration language.