winsw

by winsw

winsw / winsw

A wrapper executable that can run any executable as a Windows service, in a permissive license.

4.7K Stars 798 Forks Last release: 4 days ago (v2.10.3) MIT License 728 Commits 34 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Windows Service Wrapper in a permissive license

Github All Releases GitHub Release NuGet Build Status Deployment Status Gitter License

WinSW wraps and manages any application as a Windows service.

We are actively developing WinSW 3. Please refer to the v2 branch for previous version documentation.

Please help us prioritize items by voting or commenting on the issues!

Why?

See the project manifest.

Supported platforms

WinSW 3 can run on Windows platforms with .NET Framework 4.6.1 or later versions installed. For systems without .NET Framework, the project provides native 64-bit and 32-bit executables based on .NET Core.

More executables can be added upon request.

.NET Framework system requirements\ Preinstalled since Windows 10, version 1511 and Windows Server 2016.\ Installable since Windows 7 SP1 and Windows Server 2008 R2 SP1.

.NET 5 system requirements\ Supported since Windows 7 SP1, Windows Server (Core) 2012 R2 and Nano Server, version 1809.

Download

Latest release and pre-release WinSW binaries are available on GitHub Releases.

Alternative sources:

Usage

WinSW is being managed by the XML configuration file.

Your renamed WinSW.exe binary also accepts the following commands:

| Command | Description | | ------- | ----------- | | install | Installs the service. This command requires some preliminary steps described in the installation guide. | | uninstall | Uninstalls the service. | | start | Starts the service. | | stop | Stops the service. | | restart | Stops and then starts the service. | | status | Checks the status of the service. | | test | Checks if the service can be started and then stopped without installation. | | refresh | Refreshes the service properties without reinstallation. | | customize | Customizes the wrapper executable. | | dev | Experimental commands. |

Experimental commands:

| Command | Description | | ------- | ----------- | | dev ps | Draws the process tree associated with the service. | | dev kill | Terminates the service if it has stopped responding. | | dev list | Lists services managed by the current executable. |

Most commands require Administrator privileges to execute. WinSW will prompt for UAC in non-elevated sessions.

Documentation

Contributing

Contributions are welcome! See the contributing guidelines for more information.

License

WinSW is licensed under the MIT license.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.