Skip to content

Installation

Jump to bottom
DvNET edited this page Apr 9, 2025 · 8 revisions

This guide will walk you through the process of installing HyprDots, a complete and customized Hyprland environment for Arch Linux.

📋 Prerequisites

Before beginning the installation, ensure your system meets these requirements:

  • Arch Linux or an Arch-based distribution (Endeavour, Manjaro, etc.)
  • Wayland-compatible graphics hardware and drivers
  • Internet connection for downloading packages

🔍 Pre-Installation Checklist

  1. Backup your data: The installation script will create backups of your existing configurations, but it's always good practice to backup important data yourself.

  2. Update your system: It's recommended to update your system before installation:

    sudo pacman -Syu

  3. Install git if not already installed:

    sudo pacman -S git

🛠️ Installation Steps

1️⃣ Clone the Repository

cd
git clone --depth 1 https://github.com/Pahasara/HyprDots.git
cd HyprDots

2️⃣ Review the Installation Script (Optional)

Before running the installer, you can review what it will do:

less install.sh

The script will:

  • Check if your system is compatible
  • Create backups of your existing configurations
  • Install required packages from official repositories and AUR
  • Set up Zsh with Oh My Zsh and plugins
  • Configure system services
  • Install HyprDots configuration files

3️⃣ Run the Installation Script

chmod +x install.sh
./install.sh

Warning

Do not run the script with sudo. The script will prompt for your password when needed.

During installation:

  • You'll be asked to confirm before proceeding
  • The script will display progress information
  • You may be prompted for your password several times
  • At the end, you'll be asked if you want to reboot

4️⃣ Post-Installation

After rebooting, you'll be greeted with the SDDM login screen. Log in to your new Hyprland environment.

Key things to know after first login:

  • The Super (Windows) key is the main modifier
  • Press Super + Space to open the application launcher
  • Press Super + Return to open a terminal
  • Press Super + W to open the WiFi menu
  • Press Super + X to open the power menu

Important

If you encounter any issues, please refer to Troubleshooting.

🔄 Updating HyprDots

To update your HyprDots installation in the future:

  1. Pull the latest changes:

    cd ~/HyprDots
git pull

  2. Run the installation script again:

    ./install.sh

The script will detect existing configurations and update them accordingly.

🧹 Uninstallation

If you need to remove HyprDots:

  1. Restore your backups (located in ~/hyprdots_backup_*)
  2. Or manually remove the configurations.

📚 Next Steps

After installation, check out these pages to learn more:

If you encounter any issues not covered here, please open an issue on GitHub.

Clone this wiki locally
⚡