Arch Linux Setup and Minimalist Wayland Environment with Hyprland
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
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:
# 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_cacheMount subvolumes with appropriate options:
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/boot2. Base Installation & Configuration
# 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/hostnameConfigure mkinitcpio for Btrfs:
HOOKS=(base udev autodetect microcode modconf kms keyboard keymap console block encrypt btrfs filesystems fsck)mkinitcpio -P3. Bootloader (systemd-boot)
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.conf4. Hyprland & Wayland Ecosystem
Minimalist graphical interface with isolated Wayland packages:
# 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-git5. Hyprland Configuration
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
{
"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
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.958. Snapper & Btrfs Snapshots
# 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.timer9. NVIDIA Configuration
Add kernel parameters and environment variables for Wayland compatibility.
options root=/dev/nvme0n1p2 rootflags=subvol=@ rw quiet loglevel=3 nvidia_drm.modeset=1env = 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,direct10. Recommended Packages & Tools
| Category | Packages |
|---|---|
| Terminal | alacritty, wezterm, tabby |
| Clipboard | wl-clipboard, cliphist |
| Screenshots | grimblast-git, swappy |
| File Manager | thunar, nemo, yazi |
| Editor | neovim, helix, zed |
| Search | fzf, ripgrep, fd |
| System | btop, fastfetch, procs |
| Fonts | ttf-jetbrains-mono-nerd, noto-fonts-emoji |
11. Post-Installation Verification
# 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_TYPEAll configuration files (Hyprland, Waybar, Kitty, Rofi, SwayNC, Zsh) are maintained in the dotfiles repository. Includes installation scripts and detailed documentation.