- 1 Installation
- 2 Configuration
- 3 Troubleshooting
- 4 Using OpenRC with a desktop environment
- 5 See also
Install eitherAUR or AUR. AUR is used as init process. Services are contained in the AUR package.
To maintain compability with
/etc/openrc/. The sysvinit init binary is installed to
/usr/bin/init-openrc for compability with or similar packages.
Configuration files are installed to
/etc, similar to Gentoo.
Save a list of running daemons:
$ systemctl list-units --state=running "*.service" > daemons.list
# rc-update add alsasound default
To enable udev (disabled by default in apg):
# rc-update add udev sysinit
For booting with OpenRC add
init=/usr/bin/init-openrc to the kernel parameters. To switch back to systemd, remove the parameter again.
/etc/openrc/conf.d directory, and the
/etc/openrc/rc.d file is used for configuration.
OpenRC is booted by default. To boot with systemd, add
init=/usr/lib/systemd/systemd to the kernel line in your bootloader configuration.
/etc/conf.d directory is used for configuration.
See Network configuration for a detailed look at networking in general.
The network is configured through
newnet.  Modify the
/etc/openrc/conf.d/network file; both the
ip ( ) and the
ifconfig ( ) commands are supported. Below is an example configuration using
ip_eth0="192.168.1.2/24" defaultiproute="via 192.168.1.1" ifup_eth0="ip link set \$int mtu 1500"
The network service is added to the boot runlevel by default, so no further action is required.
To use a static route you need to create a symlink of
net.lo that reflects your device's name:
ln -s /etc/init.d/net.lo /etc/init.d/net.eth0
See  for details.
For having a graphical network manager, connman via AUR.AUR can be installed. Other options are available, like
Other option is netctl behaviour (see  if you want to enable profiles connection on booting - requires
wpa_actiond). You could consult the official documentation or old wiki documentation (be aware of consulting version later than 2012-05-13)
See Init#System logging. Relevant service files are included in AUR (apg), AUR, AUR, and AUR (artoo). It is recommended to only use a single logger as different loggers may conflict.
To enable boot logging, uncomment the
rc_logger="YES" line in
rcdir/rc.conf. apg disables it by default.
OpenRC sets the hostname from
rcdir/conf.d/hostname. The file looks as follows:
# Set to the hostname of this machine hostname="myhostname"
rcdir/conf.d/modules instead of
/etc/modules-load.d. For example:
# You should consult your kernel documentation and configuration # for a list of modules and their options. modules="vboxdrv acpi_cpufreq"
Keyboard layout can be configured via
/etc/conf.d/consolefont (artoo's way). You can also configure the settings through the
/etc/locale.conf file, which is sourced via
Error while unmounting /tmp
When shutting the system down, you might get an error message such as
* Unmounting /tmp ... * in use but fuser finds nothing [ !! ]
This can be fixed by adding
Disabling IPv6 does not work
One option is to add:
# Disable ipv6 net.ipv6.conf.all.disable_ipv6 = 1
in a file with a
.conf extension under
During shutdown remounting root as read-only fails
If the above happens, edit the
/etc/openrc/init.d/mount-ro file and put:
after the following line:
# Flush all pending disk writes now sync; sync
/etc/sysctl.conf not found
Create the file:
# touch /etc/sysctl.conf
Using OpenRC with a desktop environment
The xfce4-session package has been compiled with logind support; AUR can be used.AUR from the
Install AUR.AUR, AUR and AUR from the
If you use
/etc/pam.d/mdm, comment out
session required pam_systemd.so and restart
mdm. Additionally append
session optional pam_ck_connector.so nox11 if you have AUR installed.
The kdebase-workspace package needs to be recompiled for use with consolekit (AUR is available from the AUR).