s6-frontend
Software
skarnet.org

The /etc/s6-frontend.conf configuration file

Goal and usage

/etc/s6-frontend.conf is a configuration file provided by the distribution, or written by the system administrator, defining various settings for the s6 commands, as well as the default policies of an s6-based system (i.e. where various directories and files are located).

For instance, this is what allows the s6 process restart foobar command to send s6-svc -r to the foobar service without the user needing to type, or even remember, what the full path to the foobar service directory is.

Description

The /etc/s6-frontend.conf file follows the envfile syntax: simple key = value lines, comments permitted.

If a value is left empty, the compiled-in default is used.

The variables that can be set are the following:

scandir

The directory where s6-svscan is running. The default is /run/service (possibly overridden by the --scandir build-time configure option to or to s6-frontend).

livedir

The directory hosting the live service database managed by s6-rc. The default is /run/s6-rc (possibly overridden by the --livedir build-time configure option to or to s6-frontend).

repodir

The directory hosting the repository of service sets managed by the s6-rc repo commands. The default is /var/lib/s6-rc/repository (possibly overridden by the --repodir build-time configure option to or to s6-frontend).

bootdb

The path to the boot-time compiled service database. The default is /etc/s6-rc/compiled/current (possibly overridden by the --bootdb build-time configure option to or to s6-frontend).

stmpdir

A directory suitable for root-only runtime data and temporary files for s6-frontend. The default is /run/s6-frontend (possibly overridden by the --stmpdir build-time configure option to s6-frontend).

storelist

A colon-separated (:) list of directories containing the stores of s6-rc service definition directories. The default is /usr/share/s6-frontend/s6-rc/sources:/etc/s6-frontend/s6-rc/sources (possibly overridden by the --storelist build-time configure option to s6-frontend).

verbosity

The default verbosity for s6 and its invoked commands. 0 is terse (only print fatal error messages), 1 is normal (print error messages and warnings), over 1 is increasingly verbose (print informational messages, up to tracing and debug messages at level 4-5). The default is 1.