Config Files

General information about the config files that Regolith uses

Component	Default Config	User Config	Notes
i3-gaps	`/etc/regolith/i3/config`	`~/.config/regolith/i3/config`	In Regolith versions prior to 1.2 this file was in another directory.
Xresources	`/etc/regolith/styles/root`	`~/.Xresources-regolith` (Global override) `~/.config/regolith/Xresources` (Override) `~/.config/regolith/Xresources.d` (User files)	`~/.Xresources` is also loaded but intended for properties that may also be required in other desktop sessions.
Rofi	`/etc/regolith/styles/lascaille/rofi.rasi`	Defined in the `theme` style file.	This can also be overridden directly in the i3 file if preferred.
Bar Workspace Labels	`/etc/regolith/styles/i3-wm`	User defined
Bar status indicators	`/etc/regolith/i3xrocks/conf.d`	`~/.config/regolith/i3xrocks/conf.d`	Each block has it’s own file. Filename determines ordering.
Picom (Compton) Compositor	`/etc/regolith/picom/config`	`~/.config/regolith/picom/config`	User config added in 1.5. Each compositor has it’s own independent config file, but the default is `Picom`.
LightDM GTK Greeter	`/usr/share/lightdm/lightdm-gtk-greeter.conf.d/02_regolith.conf`	N/A	This file only exists if the `regolith-lightdm-config` package is installed.

Load Sequence

Upon session start, Regolith loads configuration files in the following order:

/usr/bin/i3-gnome-flashback executes after successful login
Load Xresources file ~/.Xresources if it exists.
Load Xresources file ~/.Xresources-regolith if it exists.
Merge any values from file ~/.config/regolith/Xresources if it exists.
If first time session has loaded, initialize system.
Compare current Xresources db against last saved hash, if different, reload GNOME settings from Xresources.
Execute i3 with first config file found from following list: ~/.config/regolith/i3/config, /etc/regolith/i3/config, /etc/i3/config.
i3 executes the UI components Rofi, i3xrocks, unclutter, regolith-compositor, Rofication, and regolith-ftue.

Was this page helpful?

Sorry to hear that. Please tell us how we can improve.