kardianos/service
Service
This project is a Go library and toolkit for cross-platform daemon orchestration. It provides a unified interface for registering and managing Go programs as background services across multiple operating systems, including Windows, macOS, and various Linux distributions.
The toolkit acts as a multi-platform init manager, interfacing with systemd, OpenRC, and launchd. It automates the lifecycle of background processes, providing capabilities to install, uninstall, start, stop, and restart applications.
Beyond service management, the library includes tools for environment detection to identify if a process is running in an interactive terminal, a container, or as a system service. It also features a system log bridge that routes application output to native facilities, such as Unix syslogs or Windows event logs, depending on the host operating system.
Features
- Service Managers - Provides a unified interface to install, uninstall, start, stop, and restart programs as background services across multiple operating systems.
- Daemon Process Management - Automates the lifecycle of background processes, including installation, startup, and removal across multiple OSs.
- Boot-Time Process Automation - Ensures applications start automatically on boot and remain active without requiring a manual user session.
- Cross-Platform Service Managers - Acts as a unified interface for registering applications with systemd, OpenRC, macOS launchd, and Windows services.
- Runtime Environment Detection - Inspects environment variables and system files to detect if the program is running in a container or terminal.
- System Service Wrappers - Provides a Go library for installing and managing programs as background services across multiple operating systems.
- Cross-Platform Init Integration - Interfaces with multiple system init managers like systemd, OpenRC, and launchd using a single unified API.
- Cross-Platform Init Abstractions - Normalizes service lifecycles across different Linux distributions by implementing distinct handlers for systemd, OpenRC, and launchd.
- Service Launcher Interfaces - Implements a unified Go interface to manage the installation and control of background services across different operating systems.
- Syslog Client Integrations - Routes service log messages to the native Unix syslog facility for consistent event logging.
- Startup Script Generation - Automatically generates native startup scripts and configuration files tailored to the detected init system or service manager.
- Application Log Routing - Directs application output to either Windows Event Logs or Unix Syslogs based on the host operating system.
- Windows Event - Sends structured information, warnings, and error messages to the Windows system event log using specific event IDs.
- Logging Framework Bridges - Bridges application output to native system logging facilities like Unix syslogs or Windows event logs.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
