man7.org > Linux > man-pages

Linux/UNIX system programming training

systemd-rc-local-generator(8) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | NOTES | SEE ALSO | COLOPHON 

SYSTEMD-...ENERATOR(8)  systemd-rc-local-generator SYSTEMD-...ENERATOR(8)

NAME         top

       systemd-rc-local-generator, rc-local.service - Compatibility
       generator and service to start /etc/rc.local during boot

SYNOPSIS         top

       /usr/lib/systemd/system-generators/systemd-rc-local-generator

       rc-local.service

DESCRIPTION         top

       systemd-rc-local-generator is a generator that checks whether
       /etc/rc.local exists and is executable, and if it is, pulls the
       rc-local.service unit into the boot process. This unit is
       responsible for running this script during late boot. The script
       is run after network.target, but in parallel with most other
       regular system services.

       Note that rc-local.service runs with slightly different semantics
       than the original System V version, which was executed "last" in
       the boot process, which is a concept that does not translate to
       systemd.

       Also note that rc-local.service is ordered after network.target,
       which does not mean that the network is functional, see
       systemd.special(7). If the script requires a configured network
       connection, it may be desirable to pull in and order it after
       network-online.target with a drop-in:

           # /etc/systemd/system/rc-local.service.d/network.conf
           [Unit]
           Wants=network-online.target
           After=network-online.target

       Support for /etc/rc.local is provided for compatibility with
       specific System V systems only. However, it is strongly
       recommended to avoid using this script today, and instead provide
       proper unit files with appropriate dependencies for any scripts to
       run during the boot process. Note that the path to the script is
       set at compile time and varies between distributions.

       systemd-rc-local-generator implements systemd.generator(7).

NOTES         top

       On systems with SELinux, when creating the file, make sure to set
       the appropriate context, e.g. with "sudo restorecon -v
       /etc/rc.local".

SEE ALSO         top

       systemd(1), systemctl(1)

COLOPHON         top

       This page is part of the systemd (systemd system and service
       manager) project.  Information about the project can be found at
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have a
       bug report for this manual page, see
       ⟨http://www.freedesktop.org/wiki/Software/systemd/#bugreports⟩.
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2025-08-11.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2025-08-11.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there is
       a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

systemd 258~rc2                                    SYSTEMD-...ENERATOR(8)

Pages that refer to this page: systemd.directives(7),  systemd.generator(7),  systemd.index(7)

HTML rendering created 2025-09-06 by Michael Kerrisk, author of The Linux Programming Interface.

For details of in-depth Linux/UNIX system programming training courses that I teach, look here.

Hosting by jambit GmbH.

Cover of TLPI