Arch Linux Setup and Minimalist Wayland Environment with Hyprland

Last Updated: 2026-11-18·Reading Time: 8 dk·Linux / Wayland

This technical guide documents the steps to set up a zero-latency, hardware-accelerated developer workstation on Arch Linux with Btrfs subvolumes, the Wayland protocol, and the Hyprland dynamic tiling window manager.

Prerequisites

Requirements & Notes

UEFI boot mode with live USB environment and active internet connection required. NVIDIA users should prefer the nvidia-open-dkms driver package.


1. Disk Partitioning & Btrfs Configuration

System stability and instant backup capability through Btrfs root formatting with subvolume layout:

Terminal (bash)
# Btrfs subvolumes (@, @home, @snapshots, @var)
mkfs.btrfs -L ARCH /dev/nvme0n1p2
mount /dev/nvme0n1p2 /mnt
btrfs subvolume create /mnt/@
btrfs subvolume create /mnt/@home
btrfs subvolume create /mnt/@snapshots
btrfs subvolume create /mnt/@var_log
btrfs subvolume create /mnt/@var_cache

Mount subvolumes with appropriate options:

Terminal (bash)
umount /mnt
mount -o noatime,compress=zstd:3,space_cache=v2,subvol=@ /dev/nvme0n1p2 /mnt
mkdir -p /mnt/{home,.snapshots,var/log,var/cache,boot}
mount -o noatime,compress=zstd:3,space_cache=v2,subvol=@home /dev/nvme0n1p2 /mnt/home
mount -o noatime,compress=zstd:3,space_cache=v2,subvol=@snapshots /dev/nvme0n1p2 /mnt/.snapshots
mount -o noatime,compress=zstd:3,space_cache=v2,subvol=@var_log /dev/nvme0n1p2 /mnt/var/log
mount -o noatime,compress=zstd:3,space_cache=v2,subvol=@var_cache /dev/nvme0n1p2 /mnt/var/cache
mount /dev/nvme0n1p1 /mnt/boot

2. Base Installation & Configuration

Terminal (bash)
# Install base system
pacstrap -K /mnt base linux linux-firmware base-devel btrfs-progs snapper grub efibootmgr networkmanager intel-ucode amd-ucode sudo vim git zsh

# Generate fstab
genfstab -U /mnt >> /mnt/etc/fstab

# Chroot into system
arch-chroot /mnt

# Timezone & localization
ln -sf /usr/share/zoneinfo/Europe/Istanbul /etc/localtime
hwclock --systohc
echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen
echo "tr_TR.UTF-8 UTF-8" >> /etc/locale.gen
locale-gen
echo "LANG=en_US.UTF-8" > /etc/locale.conf
echo "KEYMAP=trq" > /etc/vconsole.conf
echo "vamola" > /etc/hostname

Configure mkinitcpio for Btrfs:

/etc/mkinitcpio.conf
HOOKS=(base udev autodetect microcode modconf kms keyboard keymap console block encrypt btrfs filesystems fsck)
Terminal (bash)
mkinitcpio -P

3. Bootloader (systemd-boot)

Terminal (bash)
bootctl install

# /boot/loader/loader.conf
echo "default arch.conf
timeout 3
console-mode keep
editor no" > /boot/loader/loader.conf

# /boot/loader/entries/arch.conf
echo "title Arch Linux
linux /vmlinuz-linux
initrd /amd-ucode.img
initrd /initramfs-linux.img
options root=/dev/nvme0n1p2 rootflags=subvol=@ rw quiet loglevel=3" > /boot/loader/entries/arch.conf

4. Hyprland & Wayland Ecosystem

Minimalist graphical interface with isolated Wayland packages:

Terminal (bash)
# Core Wayland packages
pacman -S hyprland waybar rofi-wayland swaync kitty zsh oh-my-zsh-git powerlevel10k grimblast-git wl-clipboard slurp wf-recorder polkit-kde-agent qt5-wayland qt6-wayland xdg-desktop-portal-hyprland xdg-desktop-portal-gtk brightnessctl playerctl pamixer pavucontrol thunar thunar-archive-plugin tumbler btop fastfetch neovim

# AUR packages (using yay)
yay -S hyprpicker-git wlogout hyprlock-git hypridle-git

5. Hyprland Configuration

~/.config/hypr/hyprland.conf
monitor=DP-1,2560x1440@165Hz,0x0,1

general {
  gaps_in = 4
  gaps_out = 8
  border_size = 1
  col.active_border = rgb(38bdf8)
  col.inactive_border = rgb(27272a)
}

input {
  kb_layout = us
  kb_variant = 
  kb_model = 
  kb_options = 
  sensitivity = 0
  accel_profile = flat
}

animations {
  enabled = yes
  bezier = myBezier, 0.05, 0.9, 0.1, 1.05
  animation = windows, 1, 7, myBezier
  animation = windowsOut, 1, 7, default, popin 80%
  animation = border, 1, 10, default
  animation = borderangle, 1, 8, default
  animation = fade, 1, 7, default
  animation = workspaces, 1, 6, default
}

dwindle {
  pseudotile = yes
  preserve_split = yes
}

master {
  new_is_master = true
  new_on_top = true
}

gestures {
  workspace_swipe = on
  workspace_swipe_fingers = 3
  workspace_swipe_distance = 300
  workspace_swipe_invert = no
}

device {
  name = epic-mouse-v1
  sensitivity = -0.5
}

windowrulev2 = float, class:^(pavucontrol)$
windowrulev2 = float, class:^(nm-connection-editor)$
windowrulev2 = float, class:^(blueman-manager)$
windowrulev2 = float, class:^(pavucontrol)$

# Keybindings
$mainMod = SUPER

bind = $mainMod, Q, exec, kitty
bind = $mainMod, C, killactive
bind = $mainMod, M, exit
bind = $mainMod, E, exec, thunar
bind = $mainMod, V, togglefloating
bind = $mainMod, R, exec, rofi -show drun
bind = $mainMod, P, pseudo
bind = $mainMod, J, togglesplit

# Workspace navigation
bind = $mainMod, left, workspace, e-1
bind = $mainMod, right, workspace, e+1
bind = $mainMod, 1, workspace, 1
bind = $mainMod, 2, workspace, 2
bind = $mainMod, 3, workspace, 3
bind = $mainMod, 4, workspace, 4
bind = $mainMod, 5, workspace, 5

# Move windows
bind = $mainMod SHIFT, 1, movetoworkspace, 1
bind = $mainMod SHIFT, 2, movetoworkspace, 2
bind = $mainMod SHIFT, 3, movetoworkspace, 3
bind = $mainMod SHIFT, 4, movetoworkspace, 4
bind = $mainMod SHIFT, 5, movetoworkspace, 5

# Screenshots
bind = , Print, exec, grimblast save area
bind = $mainMod, Print, exec, grimblast save output
bind = $mainMod SHIFT, Print, exec, grimblast save active

# Audio
bind = , XF86AudioRaiseVolume, exec, pamixer -i 5
bind = , XF86AudioLowerVolume, exec, pamixer -d 5
bind = , XF86AudioMute, exec, pamixer -t

# Brightness
bind = , XF86MonBrightnessUp, exec, brightnessctl s +5%
bind = , XF86MonBrightnessDown, exec, brightnessctl s 5%-

6. Waybar Configuration

~/.config/waybar/config.jsonc
{
"layer": "top",
"position": "top",
"height": 32,
"spacing": 4,
"modules-left": ["hyprland/workspaces"],
"modules-center": ["hyprland/window"],
"modules-right": ["pulseaudio", "network", "cpu", "memory", "clock", "tray"],

"hyprland/workspaces": {
  "disable-scroll": true,
  "all-outputs": true,
  "format": "{name}",
  "format-icons": {
    "1": "1",
    "2": "2", 
    "3": "3",
    "4": "4",
    "5": "5"
  }
},

"hyprland/window": {
  "format": "{}",
  "max-length": 50
},

"clock": {
  "format": "{}",
  "format-alt": "%H:%M",
  "tooltip-format": "%A, %d %B %Y"
},

"cpu": {
  "format": "{usage}% ",
  "tooltip": false
},

"memory": {
  "format": "{}% ",
  "tooltip": false
},

"network": {
  "format": "{ifname}: {ipaddr}",
  "format-wifi": "{essid} ({signalStrength}%)",
  "format-ethernet": "Wired: {ipaddr}",
  "tooltip": false
},

"pulseaudio": {
  "format": "{volume}% {icon}",
  "format-bluetooth": "{volume}% {icon} {name}",
  "format-muted": "Muted",
  "tooltip": false
},

"tray": {
  "icon-size": 16,
  "spacing": 8
}
}

7. Kitty Terminal Configuration

~/.config/kitty/kitty.conf
font_family      JetBrains Mono
bold_font        auto
italic_font      auto
bold_italic_font auto
font_size        11.0

background       #09090b
foreground       #fafafa

cursor           #38bdf8
cursor_text_color #09090b

selection_background #38bdf8
selection_foreground #09090b

color0  #18181b
color8  #3f3f46
color1  #f87171
color9  #ef4444
color2  #4ade80
color10 #22c55e
color3  #fbbf24
color11 #f59e0b
color4  #38bdf8
color12 #0ea5e9
color5  #c084fc
color13 #a855f7
color6  #22d3ee
color14 #06b6d4
color7  #e4e4e7
color15 #fafafa

shell_integration no-cursor
enable_audio_bell no
window_padding_width 8
background_opacity 0.95

8. Snapper & Btrfs Snapshots

Terminal (bash)
# Install snapper
pacman -S snapper grub-btrfs

# Create snapper configs
snapper -c root create-config /mnt
snapper -c home create-config /mnt/home

# Configure timeline cleanup
snapper -c root set-config TIMELINE_CREATE=yes TIMELINE_LIMIT_HOURLY=5 TIMELINE_LIMIT_DAILY=7 TIMELINE_LIMIT_WEEKLY=4 TIMELINE_LIMIT_MONTHLY=12

# Enable grub-btrfs for boot menu snapshots
systemctl enable --now grub-btrfsd
systemctl enable --now snapper-timeline.timer
systemctl enable --now snapper-cleanup.timer

9. NVIDIA Configuration

NVIDIA Users Only

Add kernel parameters and environment variables for Wayland compatibility.

/etc/default/grub (or /boot/loader/entries/arch.conf for systemd-boot)
options root=/dev/nvme0n1p2 rootflags=subvol=@ rw quiet loglevel=3 nvidia_drm.modeset=1
~/.config/hypr/env.conf (source in hyprland.conf)
env = WLR_NO_HARDWARE_CURSORS,1
env = GBM_BACKEND,nvidia-drm
env = __GL_GSYNC_ALLOWED,0
env = __GL_VRR_ALLOWED,0
env = LIBVA_DRIVER_NAME,nvidia
env = NVD_BACKEND,direct

CategoryPackages
Terminalalacritty, wezterm, tabby
Clipboardwl-clipboard, cliphist
Screenshotsgrimblast-git, swappy
File Managerthunar, nemo, yazi
Editorneovim, helix, zed
Searchfzf, ripgrep, fd
Systembtop, fastfetch, procs
Fontsttf-jetbrains-mono-nerd, noto-fonts-emoji

11. Post-Installation Verification

Terminal (bash)
# Verify installation
fastfetch

# Check Btrfs subvolumes
btrfs subvolume list /

# Check snapper
snapper -c root list

# Test Hyprland
Hyprland

# Check Wayland
echo $WAYLAND_DISPLAY
echo $XDG_SESSION_TYPE

Dotfiles Repository

All configuration files (Hyprland, Waybar, Kitty, Rofi, SwayNC, Zsh) are maintained in the dotfiles repository. Includes installation scripts and detailed documentation.

•built with Next.js · v2.4.0
Arch Linux & Hyprland | vamola.dev