Suite startup sequence

The following steps describe what happens during a normal suite startup, covering both the manual entry point and the main service launcher. Environment refreshes are not triggered automatically during start; they are reserved for manual runs of env-refresh.sh or calls made as part of an upgrade.

Manual entry point (start.sh)

  • start.sh writes a note to logs/start.log to record the manual request.
  • If a managed service name exists in .locks/service.lck and systemd is available, it restarts that unit, watches for it to reach active, and exits early if successful. Otherwise, it falls back to running scripts/service-start.sh with any additional arguments.
Loading remaining sections…