Arch Linux — Complete Documentation

A comprehensive, step-by-step guide to everything Arch Linux — from installation to mastery.

---

📁 Project Structure

Arch_Linux/
│
├── README.md                          ← You are here
│
├── docs/
│   ├── commands-cheatsheet.md         ← Essential Arch Linux commands
│   ├── desktop-environments.md        ← DE/WM options and comparisons
│   ├── downloads.md                   ← Where to download Arch Linux (official links)
│   ├── install-mac-asahi.md           ← Install on Apple Silicon via Asahi Linux
│   ├── install-virtual-wsl.md         ← VirtualBox / WSL2 setup guide
│   └── install-windows-pc.md          ← Dual boot with Windows (step-by-step)
│
└── configs/
    ├── i3/
    │   └── config                     ← i3 window manager configuration
    │
    └── hyprland/
        ├── hyprland.conf              ← Hyprland compositor configuration
        ├── kitty.conf                 ← Kitty terminal emulator config
        └── waybar/
            └── config.jsonc           ← Waybar panel layout & modules

---

📚 Documentation

📄 Guides & Docs

File	Description
commands-cheatsheet.md	pacman, systemctl, ip, grep, and more
desktop-environments.md	GNOME, KDE, i3, Hyprland — comparisons & tips
downloads.md	Official mirrors and verified ISO sources
install-windows-pc.md	Dual boot Arch Linux alongside Windows
install-virtual-wsl.md	Run Arch in VirtualBox or WSL2
install-mac-asahi.md	Arch Linux on Apple Silicon (Asahi)

---

⚙️ Dotfiles / Configs

🪟 i3 Window Manager

File	Description
configs/i3/config	Keybindings, layouts, autostart, and theming

🌊 Hyprland (Wayland Compositor)

File	Description
hyprland.conf	Monitor setup, animations, keybindings, rules
kitty.conf	Font, colors, padding, and shell settings
waybar/config.jsonc	Waybar modules: workspaces, clock, tray, etc.

---

🚀 Getting Started

1. Download Arch Linux

Head to the downloads guide for official ISO links and verification steps.

2. Choose Your Installation Method

Method	Guide
🪟 Dual Boot with Windows	install-windows-pc.md
💻 VirtualBox / WSL2	install-virtual-wsl.md
🍎 Apple Silicon (Asahi)	install-mac-asahi.md

3. Choose a Desktop Environment

See desktop-environments.md for a breakdown of popular options including i3, Hyprland, GNOME, and KDE Plasma.

4. Apply the Dotfiles

Clone this repo and symlink or copy configs to your home directory:

# Clone the repository
git clone https://github.com/Linux-Operating-System/Arch_Linux.git
cd Arch_Linux

# Copy i3 config
mkdir -p ~/.config/i3
cp configs/i3/config ~/.config/i3/config

# Copy Hyprland configs
mkdir -p ~/.config/hypr ~/.config/kitty ~/.config/waybar
cp configs/hyprland/hyprland.conf ~/.config/hypr/hyprland.conf
cp configs/hyprland/kitty.conf ~/.config/kitty/kitty.conf
cp configs/hyprland/waybar/config.jsonc ~/.config/waybar/config

---

🛠️ Quick Command Reference

# Update the system
sudo pacman -Syu

# Install a package
sudo pacman -S <package>

# Search for a package
pacman -Ss <keyword>

# Remove a package
sudo pacman -Rns <package>

# Enable a service
sudo systemctl enable --now <service>

# Check system logs
journalctl -xe

📖 Full cheatsheet → commands-cheatsheet.md

---

🤝 Contributing

1. Fork this repository
2. Create a new branch: git checkout -b feature/your-topic
3. Commit your changes: git commit -m "Add: your description"
4. Push and open a Pull Request

---

📜 License

This project is open source and available under the MIT License.

---

Made with ❤️ for the Arch Linux community  |  btw, I use Arch