Lightweight & Fast
Arch Base
No Telemetry / Snaps / Flatpaks by default pure onyx install
Good for learning
Pure Onyx rejects any display manager (GDM, SDDM, LightDM). Instead, login is handled either: Lightweight & Fast
To auto‑start Sway on tty1 login, add to ~/.zprofile:
if [ -z "$WAYLAND_DISPLAY" ] && [ "$TTY" = "/dev/tty1" ]; then
exec sway
fi
For true "pure" experience, no auto‑login; user logs in then runs sway. Arch Base
A pure Onyx install does not auto-login.
# Set root password
passwd
| Issue | Probable Cause | Solution |
|-------|----------------|----------|
| Black screen after sway | Missing graphics driver (e.g., Intel, AMD, NVIDIA) | Install mesa, xf86-video-* or nvidia-dkms |
| Sway cannot open Wayland socket | XDG_RUNTIME_DIR not set | Add export XDG_RUNTIME_DIR=/run/user/$(id -u) to ~/.profile |
| Fonts appear as boxes | Missing Nerd Fonts | pacman -S ttf-jetbrains-mono-nerd & regenerate font cache |
| Waybar shows nothing | Configuration path mismatch | Verify ~/.config/waybar/config exists; run waybar from terminal for error log |
| WiFi not working in Wayland | iwd or NetworkManager not running | systemctl enable --now iwd && systemctl enable --now NetworkManager |
| Zsh theme broken | Missing powerlevel10k or syntax highlighting | yay -S zsh-syntax-highlighting zsh-autosuggestions (if AUR helper installed) |
Pure Onyx is a customized, open-source operating system designed for advanced users. This guide will walk you through the installation process of Pure Onyx.