Home - buggerman/re-arch GitHub Wiki

██████╗ ███████╗      █████╗ ██████╗  ██████╗██╗  ██╗
██╔══██╗██╔════╝     ██╔══██╗██╔══██╗██╔════╝██║  ██║
██████╔╝█████╗  ████╗███████║██████╔╝██║     ███████║
██╔══██╗██╔══╝  ╚═══╝██╔══██║██╔══██╗██║     ██╔══██║
██║  ██║███████╗     ██║  ██║██║  ██║╚██████╗██║  ██║
╚═╝  ╚═╝╚══════╝     ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝╚═╝  ╚═╝

Professional, one-command Arch Linux desktop installer with snapshots and optimizations.

Welcome to the comprehensive documentation for RE-ARCH - a production-ready Arch Linux installer that creates optimized desktop systems with multiple desktop environments, advanced snapshot management, and performance/security enhancements.

🚀 Quick Start

Prerequisites: Boot from Arch Linux ISO and connect to internet first!

New to RE-ARCH? Start here:

  1. Quick Install: curl -fsSL https://re-arch.xyz/install | bash
  2. Read the Installation Guide for detailed installation steps
  3. Check the Desktop Environment Configurations to choose your preferred DE
  4. Follow the Post-Installation Setup for essential first steps

📚 Documentation Sections

📋 Installation Guide

Complete installation instructions with step-by-step guidance for all supported desktop environments.

🔧 Troubleshooting

Comprehensive troubleshooting guide for common issues and their solutions.

🖥️ Desktop Environment Configurations

Detailed information about supported desktop environments: KDE Plasma, GNOME, XFCE, and Hyprland.

📦 Package Management

In-depth explanation of the security-first package management philosophy and architecture.

🚀 Post-Installation Setup

Essential steps and recommendations after installation, including application installation and system optimization.

⚙️ Technical Details

Advanced technical information about system architecture, Btrfs configuration, and performance optimizations.

❓ FAQ

Frequently asked questions and their answers.

🛠️ Project Philosophy

RE-ARCH is built around four core principles:

  • Simplicity: One-command installation with sane defaults and minimal user decisions
  • Performance: Linux Zen kernel, process optimization, memory compression, and low-latency audio
  • Resilience: Automatic Btrfs snapshots, bootable recovery, atomic updates, and firewall protection
  • Security: Four-tier package management (pacman for system, Flatpak for apps, AUR sparingly, Homebrew for dev tools)

🎯 Scope and Limitations

RE-ARCH is optimized for:

  • Desktop and laptop installations
  • Single-user development workstations
  • Daily-use systems with gaming and multimedia
  • Power users seeking production-ready Arch Linux

RE-ARCH is NOT designed for:

  • Server environments or headless systems
  • Multi-user production deployments
  • High-availability enterprise systems
  • Custom security compliance requirements
  • Embedded or resource-constrained hardware

🤝 Contributing to Documentation

This wiki is maintained alongside the project. To contribute:

  1. Report Issues: Use GitHub Issues for documentation bugs
  2. Suggest Improvements: Use GitHub Discussions for ideas
  3. Submit Changes: Wiki pages can be edited directly through GitHub

📞 Getting Help

🌐 Website: https://re-arch.xyz
📁 Repository: https://github.com/buggerman/re-arch
📖 Documentation: https://github.com/buggerman/re-arch/wiki

This documentation is maintained by the RE-ARCH community. Last updated: August 2025