Skip to content

Installation Guide ‐ openSUSE

Ekansh Bhavik edited this page Jan 6, 2026 · 1 revision

openSUSE Tumbleweed – Full Installation

This page provides installation steps for openSUSE Tumbleweed.

Tumbleweed is a rolling-release distribution with strong Wayland support, making it suitable for Hyprland when configured correctly.


Requirements

  • openSUSE Tumbleweed (updated system)
  • zypper working correctly
  • A working internet connection
  • Wayland-capable graphics setup

It is recommended to fully update your system before proceeding.


Recommended method (installer)

Hyprland-Rice supports openSUSE Tumbleweed through the interactive installer.

git clone https://github.com/realekansh/Hyprland-Rice.git
cd Hyprland-Rice
chmod +x install.sh
./install.sh

The installer will detect openSUSE and use zypper for package installation.

You will be asked to confirm all package and configuration changes.


Wayland and session notes

Hyprland requires a Wayland session.

If you are using a display manager:

  • Ensure Wayland sessions are enabled
  • Select Hyprland from the session list after installation

If Hyprland does not appear in your session list, log in from a TTY and start it manually to verify installation.


Manual installation (advanced)

Advanced users may choose to install packages and apply configuration files manually.

In this case:

  • Install required packages using zypper
  • Refer to distro-specific package lists in packages/
  • Copy configuration files from config/ to ~/.config

Manual installation is recommended only if you want full control.


After installation

  • Log out of your current session
  • Select Hyprland as your session
  • Log in and verify functionality

If issues occur, check the installer log file and refer to the Logs, Errors, and Bugs page.


Known notes for Tumbleweed

  • Rolling updates may occasionally introduce breakage
  • Keeping the system updated reduces compatibility issues
  • Wayland regressions are usually resolved quickly upstream

Navigation

Clone this wiki locally