terminusd docs :: configuration
Core Config

Configuring terminusd

terminusd uses /etc/terminusd.conf, but supports drop-ins in /etc/terminus.d which overrides any section in the main configuration.

By default, terminusd ships with several example configurations and scripts, but everything is disabled until explicitly enabled.

Main Daemon Configuration

  • set_max_inhibit_delay: when true, write max_inhibit_delay to InhibitDelayMaxSec in logind.conf if not set.
  • max_inhibit_delay: desired inhibit ceiling in seconds.
  • restart_logind_after_set: optionally restart logind to apply immediately.
Restarting logind will terminate active login sessions, including your current one. Use with caution. Best for automated installs.

Drop-in Configuration

  • Drop-ins are in ini-style format
  • Drop-ins override any values in any section
  • New section names append additional script actions
  • [main] is unique to terminusd core configuration and can be overridden, but cannot be used for scripts/commands

Example configuration with Shutdown Guard enabled

Shutdown Guard is disabled by default. The following configuration can be placed in either /etc/temrinusd.conf or a drop-in in /etc/terminus.d

[main]
set_max_inhibit_delay = true
max_inhibit_delay = 3600
shutdown_guard_enabled = true
shutdown_guard_type = persist
shutdown_guard_command = /usr/libexec/terminusd/examples/example-persistent-shutdown-guard.sh
shutdown_guard_run_as_user = svcuser
shutdown_guard_run_as_group = svcuser