init(1)


NAME
    init - MontaukOS init system


SYNOPSIS
    Spawned automatically by the kernel as PID 0.


DESCRIPTION
    init is the first userspace process started by the MontaukOS
    kernel. It discovers system services from 0:/config/init.toml
    and starts them in the order their tables appear in that file.

    Each enabled service is spawned as a child process. Services may
    run in the background or block startup until they exit. Disabled
    services are logged and skipped.

    Log output is timestamped and color-coded:

        HH:MM:SS   INFO   init  Starting dhcp
        HH:MM:SS     OK   init  dhcp finished (pid 1)


CONFIGURATION
    Each service is declared as a named TOML table:

        [services.dhcp]
        path = "0:/os/dhcp.elf"
        enabled = true
        wait = false

    path is required. name controls the name shown in the boot log and
    defaults to the table name. enabled and wait both default to true.
    optional skips a service whose executable is not installed.

    fallback names another configured service to start if spawning the
    service fails. A service with fallback_only = true is available as
    a fallback but is not started during the normal pass.

    After all foreground services exit, init enters an idle loop.


LOG LEVELS
    init uses four log levels, each with a distinct color:

        OK      Green    Service completed successfully
        INFO    Cyan     Informational (service starting, etc.)
        WARN    Yellow   Non-fatal warning
        FAIL    Red      Service failed to start


SEE ALSO
    dhcp(1), shell(1), syscalls(2)

Back to Documentation Index