systemd-install systemd Developer Lennart Poettering lennart@poettering.net systemd-install 1 systemd-install Enable or disable a systemd unit definition file systemd-install OPTIONS enable NAME systemd-install OPTIONS disable NAME systemd-install OPTIONS realize NAME systemd-install OPTIONS test NAME Description systemd-install enables or disables systemd units, or checks whether they are enabled, according to the installation suggestions included in the unit files. This command is useful to apply or undo the installation instructions encoded in the [Install] section of unit files. See systemd.unit5 for more information. Enabling units (as with systemd-install enable) should not be confused with activating units (as with systemctl start). The former simply installs the unit files in the configuration tree, but does not start them. The latter equals starting them, but does not necessarily require them to be enabled. Note that while systemd-install is the recommended tool to create or remove symlinks in the systemd configuration directory the administrator can also create links there manually, which is particularly useful to use configurations that deviate from the installation suggestions included in the unit files. Options The following options are understood: Prints a short help text and exits. Enable/disable a service even if it conflicts with/contradicts another service. This might have the effect of disabling another service that was enabled. Enable/disable a system service. Enable/disable a session service for the calling user. Enable/disable a session service for all users. After enabling/disabling stop/restart/stop the unit and reload manager configuration. Optionally, takes one of , , , or . If is passed the manager will not reload its configuration and no service will be started or stopped after enabling/disabling of the unit files. If is passed the daemon configuration is reloaded but the unit otherwise not started/stopped/restarted. If is passed and a unit is being enabled it will also be restarted should it already be running. If a unit is being disabled it will be stopped should it be running. In either case the daemon configuration is reloaded. is similar to this, but the unit will also be started if it is being enabled and any of the units listed in WantedBy= in the [Install] section of the unit file is already activated. Finally starts the unit unconditionally after enabling. This setting defaults to . If is specifieed but the mode value is omitted defaults to . This option has no effect when or test is used, or when systemd is not running or the command is executed in a chroot2 environment. This option is implied if the realize command is used. The following commands are understood: enable Enable one or more units. This will create a number of symlinks as encoded in the [Install] section of a unit file. disable Disable or more units. This will remove a number of symlinks as encoded in the [Install] section of a unit file. realize Does not enable or disable any unit. Checks whether any of the units specified are enabled, and then starts/stops/restarts the units accordingly. This will check for the existence of a number of symlinks as encoded in the [Install] section of a unit file, and then executes the action normally specified by . If is not specified implies mode. To override this mode specify in addition to realize. test Does not enable or disable any unit. Checks whether any of the units specified are enabled. This will check for the existence of a number of symlinks as encoded in the [Install] section of a unit file, and return with an exit code of 0 if a unit is enabled, 1 otherwise. Exit status On success 0 is returned, a non-zero failure code otherwise. See Also systemd1, systemctl1, systemd.unit5