systemd-install — Enable or disable a systemd unit definition file
systemd-install [OPTIONS...] enable [NAME...]
systemd-install [OPTIONS...] disable [NAME...]
systemd-install [OPTIONS...] test [NAME...]
systemd-install enables or disables systemd units, or checks whether they are enabled.
This command is useful to apply or undo the
installation instructions encoded in the [Install]
section of unit files. See
systemd.unit(5)
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.
The following options are understood:
--help
Prints a short help text and exits.
--force
Enable/disable a service even if it conflicts with/contradicts another service. This might have the effect of disabling another service that was enabled.
--system
Enable/disable a system service.
--session
Enable/disable a session service for the calling user.
--global
Enable/disable a session service for all users.
--realize[=MODE]
After
enabling/disabling stop/restart/stop
the unit and reload manager
configuration. Optionally, takes one
of no
,
reload
,
minimal
,
maybe
or
yes
. If
no
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 reload
is
passed the daemon configuration is
reloaded but the unit otherwise not
started/stopped/restarted. If
minimal
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. maybe
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
yes
starts the unit
unconditionally after enabling. This
setting defaults to
no
. If the mode value
is omitted defaults to
maybe
. This option
has no effect when
--global
or
test is used, or
when systemd is not running or the
command is executed in a
chroot(2)
environment.
The following commands are understood:
Enable a unit. This
will create a number of symlinks as
encoded in the
[Install]
section
of a unit file.
Disable a unit. This
will remove a number of symlinks as
encoded in the
[Install]
section
of a unit file.
Checks whether any of
the units specified are
installed. This will check for the
existence of a number of symlinks as
encoded in the
[Install]
section
of a unit file.