-
-
Notifications
You must be signed in to change notification settings - Fork 72
Installation Guide
This guide covers the requirements and various methods for installing Servy on Windows systems.
Servy is provided in two distinct builds to ensure compatibility across modern and legacy Windows environments.
- Modern Build (.NET 10.0+): Best for Windows 10, 11, and modern Windows Server.
- Legacy Build (.NET Framework 4.8): Best for Windows 7, 8, and older Server editions.
Caution
Administrator privileges are required to install Servy and to manage Windows services.
| Feature | .NET 10.0+ Version (Modern) | .NET Framework 4.8 Version (Legacy) |
|---|---|---|
| Filename | servy-x.x-x64-installer.exe |
servy-x.x-net48-x64-installer.exe |
| OS Support | Windows 10 (1809+), 11, Server 2016+ | Windows 7 SP1, 8.x, Server 2008 R2+ |
| Dependencies | None (Self-contained) | .NET Framework 4.8 |
| Performance | Optimized (Modern Runtime) | Standard (Legacy Runtime) |
Note on Legacy OS: While the .NET 10.0 build may run on Windows 7, it is unsupported. For Windows 7 SP1 or Windows Server 2008 R2, you must use the .NET Framework 4.8 build to ensure stability.
You have two options to install Servy. Download and install manually or use a package manager such as WinGet, Chocolatey, or Scoop.
WinGet
winget install servyChocolatey
choco install -y servyScoop
scoop bucket add extras
scoop install innounp
scoop update innounp
scoop install servy
- Download the latest release.
- Run the installer (you will be prompted for admin rights).
- Launch Servy from the Start Menu or desktop shortcut.
You can install Servy silently (without any UI) from an administrator command prompt using the following commands:
# For .NET 10.0+
.\servy-<version>-x64-installer.exe /VERYSILENT /NORESTART /SUPPRESSMSGBOXES /SP- /CLOSEAPPLICATIONS /NOCANCEL
# For .NET Framework 4.8
.\servy-<version>-net48-x64-installer.exe /VERYSILENT /NORESTART /SUPPRESSMSGBOXES /SP- /CLOSEAPPLICATIONS /NOCANCELUsing PowerShell:
# For .NET 10.0
Start-Process -FilePath ".\servy-<version>-x64-installer.exe" -ArgumentList '/VERYSILENT /SUPPRESSMSGBOXES /NORESTART /SP- /CLOSEAPPLICATIONS /NOCANCEL' -Verb RunAs -Wait
# For .NET Framework 4.8
Start-Process -FilePath ".\servy-<version>-net48-x64-installer.exe" -ArgumentList '/VERYSILENT /SUPPRESSMSGBOXES /NORESTART /SP- /CLOSEAPPLICATIONS /NOCANCEL' -Verb RunAs -Wait
# Refresh PATH in current session
$env:Path = (((
[Environment]::GetEnvironmentVariable('Path', 'Machine'),
[Environment]::GetEnvironmentVariable('Path', 'User')
) -join ';').Split(';', [StringSplitOptions]::RemoveEmptyEntries) |
Select-Object -Unique) -join ';'You need to wait a little while for Servy to finish installing.
If you face any issues, enable logging by adding the following option:
/LOG="servy-install.log"To install the CLI only, use these options:
/SetupType=custom /Components=install_cli
To install the desktop app only, use these options:
/SetupType=custom /Components=install_main_app
To install the manager app only, use these options:
/SetupType=custom /Components=install_manager
To install the desktop app and CLI only, use these options:
/SetupType=custom /Components=install_main_app,install_cli
To install the manager app and CLI only, use these options:
/SetupType=custom /Components=install_manager,install_cli
You can uninstall Servy silently (without any UI) from an administrator command prompt using the following command (PowerShell):
# For .NET 10.0+ and .NET Framework 4.8
& "C:\Program Files\Servy\unins000.exe" /VERYSILENT /NORESTART /SUPPRESSMSGBOXES| Switch | Description |
|---|---|
/VERYSILENT |
Installs completely silently with no wizard or progress windows. |
/NORESTART |
Prevents automatic system restart after installation. |
/SUPPRESSMSGBOXES |
Suppresses all message boxes, including errors, during installation. |
/SP- |
Disables the “This will install...” startup prompt. |
/CLOSEAPPLICATIONS |
Asks running apps to close if they block files. |
/NOCANCEL |
Prevents the user from canceling the installation. |
Servy is digitally signed and has been reviewed by Microsoft Security Intelligence, confirming that it is safe. It performs only standard installation tasks and does not contain malware, adware, or unwanted software. Servy passes VirusTotal scans and is published in the Windows Package Manager (WinGet), Chocolatey, and Scoop. You can safely install Servy from GitHub, WinGet, Chocolatey, or Scoop.
To ensure smooth operation of the Servy Windows services, it is recommended to add the following folders to your Microsoft Defender or third-party antivirus exclusion list:
%ProgramData%\Servy
%ProgramFiles%\Servy
This prevents antivirus software from interfering with the execution of service binaries managed by Servy.
Copyright © Akram El Assas. All rights reserved.
- Home
- Overview
- Installation Guide
- Advanced Configuration
- 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