Skip to content
Akram El Assas edited this page Aug 15, 2025 · 15 revisions

Running an Executable as a Service

  1. Open Servy as administrator.
  2. Fill in the service details:
    • Service Name – required
    • Description – optional
    • Startup Type – optional
    • Process Path – required (path to executable)
    • Startup Directory – optional (defaults to executable's directory)
    • Process Parameters – optional
    • Process Priority – optional
    • Stdout/Stderr File Paths – optional logging with size rotation
    • Heartbeat Interval – optional (default: 30s)
    • Max Failed Checks – optional (default: 3)
    • Recovery Action – optional (Restart Service, Restart Process, Restart Computer, None)
    • Max Restart Attempts – optional (default: 3)
    • Environment Variables – optional (Environment variables for the process. Enter variables in the format varName=varValue, one per line or separated by semicolons. Use \= to escape = and \; to escape ;. To include a literal backslash before = or ;, use double backslashes \\.)
    • Service Dependencies - optional (One or more Windows service names (not display names) that this service depends on. Enter each service name on a new line or separate them with semicolons (;).)
    • User Account - optional (The account under which the service will run, e.g. .\username or DOMAIN\username)
    • Password - optional (Password for the specified account)
  3. Click Install to register the service.
  4. Start/Stop/Restart the service from Servy, services.msc, or any service manager.

Pre-Launch Script Execution

Servy supports running an optional script or executable before the main service starts. This can be used for tasks like:

  • Preparing or generating configuration files
  • Fetching secrets or credentials dynamically
  • Running any setup or initialization required before the main process

Pre-Launch Settings

  • Pre-Launch Executable Path – full path to the pre-launch script or executable
  • Pre-Launch Startup Directory – working directory for the pre-launch process (optional; defaults to main service working directory)
  • Pre-Launch Parameters – command-line arguments for the pre-launch executable
  • Pre-Launch Environment Variables – optional environment variables for the pre-launch process (same format as main process)
  • Pre-Launch Stdout/Stderr File Paths – log files for capturing output and errors
  • Pre-Launch Timeout (seconds) – maximum allowed time per attempt (default: 30 seconds)
  • Pre-Launch Retry Attempts – number of retries on failure (default: 0)
  • Ignore Failure – if enabled, service startup proceeds even if pre-launch script fails

The pre-launch script is executed synchronously. If it fails or times out (and Ignore Failure is disabled), the main service will not start.

Export/Import Services

Servy allows you to export and import service configurations through both its GUI and CLI.

For detailed instructions, see the full documentation: Export/Import Services

Managing Services

  • Start/Stop/Restart the service from the UI or Windows Services tool.
  • Install/Uninstall the service from the UI.
  • Real-time monitoring of service status and logs.
Clone this wiki locally