M-Archy Dotfiles

Arch Linux · Hyprland · Wayland · CyberQueer

Production-grade Arch Linux config for network administration, development, and gaming.

---

Quick Start

git clone https://git.abdelbaki.eu/The_miro/Dotfiles.git ~/Dotfiles
bash ~/Dotfiles/setup/tui-install.sh

The TUI installer covers: packages, desktop environment, optional apps, and colour palette. To add modules to an existing system: bash ~/Dotfiles/setup/install-modules.sh

---

Cliff Notes

• Single source of truth for colours — edit colors.conf, run apply-theme.sh to propagate everywhere.
• Answerfile — generate with setup/generate-answerfile.sh, place at /answerfile.json for a fully automated install. Passwords are never stored in it.
• Hostname uniqueness — the MAC address of the primary NIC is appended automatically when an answerfile hostname is set (myhost → myhost-aabbccddee11).
• LUKS encryption — backup key is auto-generated from /dev/urandom, enrolled in a second LUKS slot, written to /_LUKS_BACKUP_KEY (root-only, inside the encrypted container). Collectable via Ansible.
• Custom ISO — setup/archiso/ builds a live USB that can embed a pre-baked answerfile for zero-touch deployment.
• Modular — core, shell, services, and desktop are independent components; pick only what you need.

---

Documentation

Full docs live in docs/md/ (Markdown) and docs/html/ (rendered).

Topic	Markdown	HTML
Overview & repo layout	index.md	index.html
Installation (TUI, answerfile, ISO)	installation.md	installation.html
Hyprland desktop	hyprland.md	hyprland.html
Theming & CyberQueer palette	theming.md	theming.html
Optional modules & app catalogue	modules.md	modules.html
Custom Archiso builder	archiso.md	archiso.html
FreeIPA & Ansible	freeipa-ansible.md	freeipa-ansible.html
Editors (Neovim, Micro, Yazi)	editors.md	editors.html
Utilities (encrypt, ClamAV, updates)	utilities.md	utilities.html

The old readme is preserved at readme.md.old.