winsw: Windows service wrapper in less restrictive license
WinSW is an executable binary, which can be used to wrap and manage a custom process as a Windows service.
Once you download the installation package, you can rename
winsw.exe to any name, e.g.
See the project manifest.
Some releases (e.g. alpha- and beta-versions) can be also downloaded from the project's GitHub page. This source of releases is not an official one.
winsw.exe binary also accepts the following commands:
installto install the service to Windows Service Controller. This command requires some preliminary steps described in the Installation Guide.
uninstallto uninstall the service. The opposite operation of above.
startto start the service. The service must have already been installed.
stopto stop the service.
restartto restart the service. If the service is not currently running, this command acts like
statusto check the current status of the service. This command prints one line to the console.
NonExistentto indicate the service is not currently installed,
Startedto indicate the service is currently running, and
Stoppedto indicate that the service is installed but not currently running.
Supported .NET versions
1.x Executable is being built with a .NET Framework
2.0 target, and by defaut it will work only for .NET Framework versions below
On the other hand, the code is known to be compatible with .NET Framework
4.0 and above.
It is possible to declare the support of this framework via the
See the Installation Guide for more details.
2.x offers two executables, which declare .NET Frameworks
4.0 as targets.
Naming and download sources for these binaries are currently in flux.
- Installation Guide - Describes the installation process for different systems and .NET versions
- Release notes
- Configuration Management:
This is a new release line under active development. API stability is not guaranteed till the first release, the project structure is in flux.
Major changes since 1.x:
- Rework of the project structure
- Better logging
- Internal extension engine, which allows extending the WinSW behavior
- Executable package targeting the .NET Framework 4.0
This is an old baseline of WinSW. Currently it is in the maintenance-only state. New versions with fixes may be released on-demand.
- IDE: Visual Studio Community 2013 (free for open-source projects)
winsw-key.snkshould be available in the project's root in order to build the executable
- You can generate the certificate in "Project Settings/Signing"
- The certificate is in
.gitignorelist. Please do not add it to the repository