How to Install GNOME on OpenBSD (Step-by-Step Guide)

How to Install GNOME on OpenBSD (Step-by-Step Guide)

bsd desktop bsd unix gnome desktop howto linux alternative open source os openbsd openbsd gui unix desktop x11

Abdullah Musa

August 16, 2025

Stability isn't just about a system that doesn't crash; it's about a workflow that feels consistent every time you log in. When you pair the iron-clad security of OpenBSD with the polished, distraction-free environment of GNOME, you create a professional workstation that is built to last.

Welcome back to MusaBase! If you have been following my recent series on BSD systems, you have already mastered the initial installation of OpenBSD: The Most Secure Unix-like OS and explored setting up KDE Plasma as a robust desktop on OpenBSD.

In this follow-up, we will continue the journey by installing and configuring the GNOME desktop on your OpenBSD system. By setting this up alongside KDE Plasma, we will add incredible flexibility to our environment, allowing you to switch between two of the most powerful and feature-rich desktop environments available. In this guide, we will cover how to:

• Prepare the OpenBSD base system for the GNOME software stack
• Download and install official GNOME packages via pkg_add
• Configure the essential system services needed by GNOME
• And finally, launch your first GNOME session on OpenBSD

By the end of this guide, you will have a fully functional GNOME desktop running alongside KDE Plasma on your OpenBSD system, ready to use whenever you choose. So without further ado, let's get started!

---

Table of Contents:

• Prerequisites
• Step 1: Prepare OpenBSD System
• Step 2: Install GNOME
• Step 3: Configure OpenBSD Services for GNOME Session
• Step 4: Start GNOME Session on OpenBSD
• What's Next?

---

Prerequisites

This guide assumes that you already have a base OpenBSD system installed on your PC. It is essential that your installation includes support for the X Window System, as GNOME requires it to function properly.

If you haven't reached this stage yet, you can follow my step-by-step walkthrough on setting up OpenBSD from scratch, making sure to enable the X Window System during the process. Once your base system is ready, return here to install the GNOME desktop.

---

Step 1: Preparing OpenBSD System for GNOME

Before we start the GNOME installation, it is important to ensure the base system is fully patched. Running these updates helps avoid compatibility issues between the kernel and the desktop environment components. Keeping your system current ensures you have the latest security fixes and stable drivers ready for a smooth desktop experience.

1.1: Patching the Base OS

The syspatch utility is the standard way to apply official binary patches to the OpenBSD base. It handles core system utilities and security vulnerabilities without touching your personal files.

• Run the following to apply base patches:

doas syspatch

The syspatch tool is specifically for the base system, including the kernel and system libraries.

1.2: Refreshing Installed Applications

Once the base is patched, we use the pkg_add -u command to upgrade your third-party packages. This ensures that software like sudo or nano is running the latest version available in the repositories.

• To sync your apps, execute:

doas pkg_add -u

This command only upgrades software located in /usr/local that was originally installed via the package manager.

After completing these updates, simply restart your machine using doas reboot to apply all changes. Now we are ready to proceed with the actual GNOME installation.

---

Step 2: Install GNOME

We only need to install the GNOME package, which will provide us with all the core components, tools, and services that we usually get on a Linux system for the GNOME desktop environment. To install GNOME, run:

doas pkg_add gnome
# OR
sudo pkg_add gnome

gnome: This package alone contains numerous other packages that are part of the GNOME Suite. This package is designed to add the core GNOME experience to your system (e.g., GNOME shell, Nautilus, etc.).

GNOME Extras

If you want the full GNOME Ecosystem, then you can also install the gnome-extra package. To install the full GNOME suite, run:

doas pkg_add gnome-extras

gnome-extras will install extended packages on your system that expand the GNOME ecosystem by adding a wider collection of applications. It provides development tools and other GNOME applications that are useful within the GNOME environment.

---

Step 3: Configure OpenBSD Services for GNOME Session

Now, we need to make only a few adjustments to OpenBSD services, like messagebus and display manager (xenodm). And enable some additional services that come with the GNOME package that we installed in the last step.

3.1: Disable XENODM

OpenBSD's default display manager is xenodm, which comes with X11 while installing the OpenBSD system. However, to run GNOME we need GDM, but OpenBSD allows only one graphical login manager at a time. To run a GNOME session, we must disable xenodm.

• To disable xenodm, simply run:

doas rcctl disable xenodm
# OR
sudo rcctl disable xenodm

3.2: Enable Display & Other Services

• Run:

doas rcctl enable messagebus gdm multicast avahi_daemon
# OR
sudo rcctl enable messagebus gdm multicast avahi_daemon

These services are required to run the GNOME session on OpenBSD. messagebus and gdm are most important to run the GNOME desktop environment, while the other multicast and avahi_daemon are required for networking.

• messagebus: This starts the dbus daemon that is the core component for running any desktop environment.
• gdm: GNOME Display Manager is a graphical login manager that provides the login screen for GNOME and also starts the GNOME session.
• multicast: This enables the Kernel's support for forwarding multicast network packets.
• avahi_daemon: This daemon implements zero-configuration networking and helps our system automatically discover network services like file shares.

3.3: Reboot

• Next, simply run the reboot command:

doas reboot
# OR
sudo reboot

---

Step 4: Start GNOME Session on OpenBSD

• After rebooting, you should boot into GDM to log into your system:

• Enter your user's password and after a few seconds, you will be inside GNOME's Desktop Home Screen:

And you are in!

---

🚀 GNOME on OpenBSD is Ready!

Well, now you have a fully functional GNOME desktop session up and running on your system. OpenBSD provides a rock-solid foundation for this environment, and I hope this guide made the installation process easy for you. I will be uploading more guides on other desktop sessions and Wayland compositors, such as Hyprland for OpenBSD, so stay tuned for those updates.

Explore More OpenBSD Desktops

🌟 KDE Plasma: If you want to experience another powerful desktop, follow my guide on installing KDE Plasma on OpenBSD.

⚡ XFCE Environment: For those who prefer a lightweight and fast desktop experience, check out how to install XFCE on OpenBSD.

🛠️ Support & Feedback: If you hit any error at any step or have problems while logging into your desktop session, please let me know in the comments below. I will be more than happy to help.

If this guide helped you set up your OpenBSD workstation, subscribe to the MusaBase newsletter for more security-focused BSD tutorials.
101 out, I’ll see you in the next one! 🚀

Abdullah Musa August 16, 2025