RE init system configuration guide

This page will guide you through configuration of Re init system on your Linux machine.

1. Adding and removing services
2. Running graphical session (X11 & Wayland)
3. Running Pipewire

1. Adding and removing services

If you want to create a core-service (service that is being run before post-mount services) you can add it to /etc/re/core-services directory. Simply add shell script with shebang at the top and the code you want to run each boot. Add there services only that are required to ensure basic functionality of operating system. Services like NetworkManager, tty or dbus should be added to /var/sv directory.

To disable service simply remove the file that starts it from your core-service or service directory.

2. Running graphical session (X11 & Wayland)

To start graphical session you have to run: udevd, dbus. Add these services to given directories

01-udevd.sh /etc/re/core-services
Either run 02-filesystems.sh or 02-filesystems.bin and move it to /etc/re/core-services
03-hostname.sh

To add dbus to autostart add this to your /var/sv/dbus file:

#!/bin/sh
mkdir -p /run/dbus exec dbus-daemon --system

2.1. Running X11 session without display manager

Now, to run X11 session simply add to your ~/.xinitrc file command that will start your de/wm. Add this to your ~/.xinitrc file and replace COMMAND with your actual command to start your desktop environment/window manager

#!/bin/sh
exec COMMAND

And then run startx.

2.2. Display Manager

To run other sessions you can download your favourite display manager (sddm, lightdm, gdm etc.) and create a service in /var/sv that will start display manager each boot.

Example service to start lightdm:

#!/bin/sh
mkdir -p /run/lightdm exec lightdm

Running Pipewire

This guide was moved to re/pipewire.