System Configuration

Learn how to change settings in the Regolith desktop.

GNOME control center (also known as Settings).

A key difference between Regolith and other environments described as minimal is the integration of the GNOME settings backend. This provides a well-tested, consistent, and friendly way of configuring your environment and computer. To load the settings app, launch “Settings” from Rofi or press super c.

Settings is a special app in Regolith in that it is launched in floating mode. This is because typically when loading settings a user is looking to make a specific change and then exit back to their work. Once loaded use the tab sections on the left of the window to select which item you wish to configure.


The i3 window manager is not part of GNOME and so it's configuration is not viewable or changable from the GNOME control center. Rather, the user must edit the config file and reload i3 to make changes. In Regolith, the i3 config file is at /etc/regolith/i3/config and users can supply their own copy that will override this default if placed at ~/.config/regolith/i3/config.

Many things about Regolith can be configured in the i3 config file. It is best to read the i3 user guide to understand what and how to modify this file.


The i3bar configuration is defined in the i3 config file listed directly above, but the i3bar has it's own configuration for status items. To change which information is displayed in the bar, the default file is /etc/regolith/i3xrocks/config and can be overridden by the user by specifying a new path in the i3 config file, as described above.

Most status elements in the bar are configured to launch an app upon click that is associated with the data presented by the element. For example the date/time element will launch the time settings panel in gnome-control-panel. These scripts live in /usr/share/i3xrocks and can be configured as needed.


The look of Regolith is configured via Xresources, that live in /etc/regolith/styles/. This topic is covered in detail in the Customize section of the documentation.


When Regolith is initially loaded, a script is run that configures the system and launches i3-wm. While it is not recommended to modify this script, it can provide details about how Regolith is structured and what policy it implements when loading configuration. This file is readable at /usr/bin/i3-gnome-flashback. In fact, this script could be considered the initial seed of the Regolith project and was taken from the i3-gnome-flashback project.