-
-
Notifications
You must be signed in to change notification settings - Fork 51
Overview
Servy provides a modern and intuitive interface to run any app as a native windows service with powerful configuration and management options.
The following figures illustrate the key parts of the desktop app, Manager app, and CLI/PowerShell integration.
This tab lets you configure the main service properties such as name, description, executable path, startup directory, and startup type.
This tab lets you configure stdout/stderr logging, including size-based log rotation, date-based log rotation, the maximum number of rotated log files to retain, and additional options such as enabling debug logs.
For detailed information about logging, check out Logging & Log Rotation documentation.
Here you can set up recovery actions (restart service, restart process, restart computer, or run a failure program) to automatically handle process crashes and failed health checks.
For detailed information about health monitoring and recovery, check out Health Monitoring & Recovery documentation.
The advanced tab provides additional configuration options such as environment variables and service dependencies.
For detailed information about environment variables, check out Environment Variables documentation.
For detailed information about service dependencies, check out Service Dependencies documentation.
This tab lets you configure the service account, with support for local accounts, domain and Active Directory accounts, as well as Group Managed Service Accounts (gMSA).
Servy securely encrypts stored passwords using AES. For more details, see the Security page.
You can also run the service under:
NT AUTHORITY\NetworkServiceNT AUTHORITY\LocalService- Passwordless accounts
Important
Permissions: If the service runs under an account other than LocalSystem, NetworkService, or LocalService, you must grant Write access to %ProgramData%\Servy for that account. See the Security page for more information.
Scoop Users: If you installed via Scoop, permissions are not set automatically. You must manually grant NetworkService or LocalService access to the %ProgramData%\Servy folder.
Configure an optional pre-launch program that runs before the main service process starts. This can be used to prepare the environment, set up dependencies, or run initialization scripts. By default, pre-launch hook runs synchronously with a timeout. If it fails, the service won't start unless Ignore Failure is enabled.
Set the timeout to 0 to run the pre-launch hook in fire-and-forget mode. When set to 0, the hook is started and the service is launched immediately without waiting for completion. Use this only for tasks that do not affect the service's ability to start or run correctly. Stdout/Stderr redirection and retries are not available in fire-and-forget mode.
Orphaned fire-and-forget pre-launch hooks are cleaned up when the service stops.
For detailed information about pre-launch hook, check out Pre‐Launch & Post‐Launch Actions documentation.
Configure an optional post-launch program that runs after the process starts successfully.
Orphaned post-launch hooks are cleaned up when the service stops.
For detailed information about post-launch hook, check out Pre‐Launch & Post‐Launch Actions documentation.
Configure an optional script or executable to run before the main service stops. This can be used for graceful shutdown tasks such as notifying external systems or draining resources. The pre-stop process runs synchronously and extends the service stop timeout while it is running. Set the timeout to 0 to run the pre-stop process in fire-and-forget mode.
For detailed information about pre-stop hook, check out Pre‐Stop & Post‐Stop Actions documentation.
Configure an optional script or executable to run after the wrapped process and all of its child processes have exited. The post-stop process is started in fire-and-forget mode and does not block service shutdown.
For detailed information about post-stop hook, check out Pre‐Stop & Post‐Stop Actions documentation.
Servy Manager is a utility for Servy that provides a centralized interface to manage all services installed or imported into Servy.
The Manager provides a central place to view all installed services, their status, CPU & RAM usage in real time, and quick actions (start, stop, restart, install, uninstall, remove, edit, copy PID).
Monitor CPU & RAM usage in real time from the Performance tab with live graphs.
Monitor service stdout and stderr output in real time from a single, unified console.
The Console view automatically loads recent log history, continues tailing live output, and keeps both streams ordered by timestamp for accurate troubleshooting.
You can filter logs instantly, pause updates while selecting or copying text, and resume live streaming without losing context.
The Dependencies tab provides a visual representation of a service dependency tree retrieved from the Service Control Manager (SCM). Each dependency is displayed with its current status, where running services are shown in green, stopped services in red, and cycles in orange. The tree can be refreshed at any time using the Refresh button or by pressing F5.
This view is especially useful for understanding startup and shutdown order, diagnosing why a service fails to start, and quickly identifying stopped or missing dependencies that may impact service availability.
Servy writes logs to the Windows Event Log, and its built-in log viewer lets you inspect them in real time directly from the GUI.
Servy also comes with a PowerShell module and CLI commands, enabling full automation and integration into CI/CD pipelines.
After installation, the Servy directory is automatically added to the system PATH environment variable. This allows you to run servy-cli.exe directly from any elevated Command Prompt or PowerShell session.
Copyright © Akram El Assas. All rights reserved.
- Home
- Overview
- Installation Guide
- Usage
- Servy Desktop App
- Servy Manager
- Servy CLI
- PowerShell Module
- Examples & Recipes
- Logging & Log Rotation
- Health Monitoring & Recovery
- Environment Variables
- Service Dependencies
- Pre‐Launch & Post‐Launch Actions
- Pre‐Stop & Post‐Stop Actions
- Shutdown & Teardown
- Export/Import Services
- Automation & CI/CD
- Integration with Monitoring Tools
- Service Event Notifications
- Comparison with Alternatives
- Security
- Architecture
- Building from Source
- Troubleshooting
- FAQ