Maze Linux / Wiki

Maze Commands

Every maze-* command shipped on the system, in one place. Where a GUI exists, the GUI is usually the recommended route. Not every command has a --help flag — and one of them (maze-panic) acts the moment you run it, so read its row before trying it.

Maze Control Center


Emergency

CommandWhat it does
maze-panicPanic button (also Ctrl+Alt+P and the tray widget). Cuts the network, locks the screen, wipes system logs, shell histories, recent files and clipboard. Takes no options — any invocation, including maze-panic --help, triggers it. See Kill Switches.
maze-panic-restoreBrings the network and radios back after a panic.
maze-killswitchKill switches from the shell: maze-killswitch status, maze-killswitch <camera|microphone|bluetooth|wifi|usb> <on|off>.

Diagnostics and health

CommandWhat it does
maze-doctorFull, read-only health report (18 sections). --deep adds a file check of every package (pacman -Qkk), --no-color gives plain text for bug reports.
maze-boot-checkVerifies the boot chain end to end (11 checks). --repair rebuilds and re-signs, --quiet prints nothing (exit code only), --no-flag does not write the unsafe-boot flag.
maze-boot-entriesLists firmware boot entries left by earlier installs; --clean removes the dead ones (asks first).
maze-auditChecks the installed machine against what the Maze source says the installer should have produced. --deep for more.
maze-selftestProves the latest round of security fixes is installed and working. Read-only.
maze-sandbox-checkChecks that the sandboxed Maze daemons can still do their jobs under their systemd restrictions.
maze-exerciseRehearses a kernel update and daemon restarts, then runs maze-audit. Changes state — a testing tool.
maze-sentinel / maze-sentinel-setupMaze Sentinel: desktop alerts for security-relevant changes (accounts, sudoers, SSH keys and config, new SUID-root binaries, new UID 0 accounts). Both services are enabled on installed systems. Unrelated to the optional sentinai package.

If maze-boot-check fails it writes /var/lib/maze/boot-unsafe, and maze-boot-guard then holds a shutdown inhibitor — the machine will refuse to power off cleanly while the boot chain looks broken. That is deliberate: it stops you rebooting into an unbootable system. See Diagnostics.


Boot and kernel

CommandWhat it does
maze-kernelKernel Switcher GUI — set the default kernel, install or remove linux-zen / linux-hardened.
maze-kernel-helperPrivileged backend for the GUI (install, remove, set-default, clear-default); the GUI calls it through pkexec.
maze-initramfs-rebuildThe command to run after editing /etc/kernel/cmdline or mkinitcpio.conf: rebuilds initramfs + UKI for every kernel and re-signs. (mkinitcpio -P does nothing on Maze.)
maze-kernel-install-addRuns kernel-install add for upgraded kernels (called by a pacman hook).
maze-sb-signSigns the UKI with your machine key and installs it as EFI/BOOT/grubx64.efi; keeps the previous image and the recovery entry. Optional argument: the ESP mount point.
maze-sb-rotate-keyReplaces your machine's Secure Boot key in stages (start → continue …, cancel to back out). Never runs automatically.
maze-boot-notifyThe login notification shown when the boot chain is unsafe.
maze-boot-guardThe shutdown inhibitor described above.

See Kernel Management and Secure Boot.


Snapshots

CommandWhat it does
maze-rollbackLists snapshots; maze-rollback <n> rolls the system back (takes effect after reboot); --undo reverses it.
maze-enable-rollbackOne-time setup for systems installed from an older ISO; --apply to make the change.
maze-snapshots-setupCreates the snapper configuration (runs once on first boot).

See Snapshots & Rollback.


Security and privacy

CommandWhat it does
maze-hardwareMaze Hardware — the kill-switch window (camera, microphone, Bluetooth, Wi-Fi, USB). See Kill Switches.
maze-guardd / maze-guardctlThe root broker behind the kill switches and panic mode, and its unprivileged client. Not Maze Guard.
maze-guardMaze Guard, the network attack monitor (daemon: maze-guard.service). maze-guard --doctor self-tests every feature.
maze-cloakMaze Cloak, MAC randomization. maze-cloak --status prints the state in a terminal.
entropy-shieldEntropy Shield — Tor, DNSCrypt, I2P and onion server (GUI).
qlamQLAM antivirus app (daemon: qlamd.service).
maze-enable-blackarchAdds the BlackArch repository using BlackArch's own strap.sh.

System and desktop

CommandWhat it does
mazelinuxCommand-line companion: system and Maze status at a glance.
maze-control-centerControl Center GUI.
maze-welcomeThe welcome app shown on first login.
maze-flatpak-setupAdds Flathub on the first boot with internet.
maze-gpu-driverInstalls and configures the proprietary NVIDIA driver (opt-in).
maze-power-saverBattery-life tuning that works alongside power-profiles-daemon. --check reports only, --uninstall reverts.
maze-primary-screenPicks the highest-resolution monitor as primary on first login.
maze-apply-wallpaperApplies the Maze wallpaper to every screen (runs at login).
maze-install-vmwareInstalls VMware Workstation from the AUR (needs internet).
maze-aur-setupFinishes the installation if the installer could not reach the network (ONLYOFFICE and the other AUR apps).
maze-connect-approversManages approving sudo/polkit prompts from your phone — see Maze Connect.

Related