Configure service startup and restart behaviour
Run Zotonic under the installation’s service manager.
Access needed: Server administrator.
Choose one owner for the Zotonic process: the host's service manager or the container platform. Agree the service user, working directory, configuration paths, persistent storage, and log destination.
- Use the installation's reviewed service definition and ensure it runs Zotonic as the intended unprivileged account.
- Verify that Erlang/OTP 28 and required external programs are on that service's path, not only your interactive shell's path.
- Check database availability, filesystem permissions, restart policy, and shutdown timeout.
- Start through the service manager and check both its state and
bin/zotonic status. - Restart in acceptance and verify the public page, login, and an uploaded file survive.
- Test startup after a host restart in acceptance before relying on automatic recovery.
Do not simultaneously start a foreground debug node using the same ports and node name. Keep service-specific commands in the installation's operating notes: systemd, containers, and hosted platforms differ. The older Cloud-Init and init-script examples need platform review before reuse.