Skip to main content
Manage runit services.

Functions

runit.service

Manage the state of runit services.
runit.service(
    service,
    running=True,
    restarted=False,
    reloaded=False,
    command=None,
    enabled=None,
    managed=True,
    svdir="/var/service",
    sourcedir="/etc/sv",
)

runit.manage

Manage runit svdir links.
runit.manage(
    service,
    managed=True,
    svdir="/var/service",
    sourcedir="/etc/sv",
)

runit.wait_runsv

Wait for runsv for service to be available.
runit.wait_runsv(
    service,
    svdir="/var/service",
    timeout=10,
)

runit.auto

Start service automatically by managing the service/down file.
runit.auto(
    service,
    auto=True,
    sourcedir="/etc/sv",
)

Examples

from pyinfra.operations import runit

# Manage a runit service
runit.service(
    name="Ensure nginx is running",
    service="nginx",
    running=True,
    enabled=True,
)

Build docs developers (and LLMs) love