Skip to main content

A system for controlling process state under WINDOWS

Project description

Supervisor is a client/server system that allows its users to control a number of processes on Windows operating system.

Supported Platforms

Supervisor has been tested (Python 2.7/3.7 [32/64 bit]) and is known to run on Windows 10 / Server 2012.

  • New processes are created by the subprocess standard lib.

  • Some specific features of OS Linux have been disabled and others were adapted to the Windows OS.

  • The process control (supervisorctl) works and management processes correctly, as well as control via web!

How to install ?

Installation can be done via pip

python -m pip install supervisor-win

  • Note that the package name is different from the unix version.

It is also possible to install the development version

python -m pip install git+

Install as Windows service

To install supervisor as a windows service run the command

python -m install -c {system-path}\\supervisord.conf

Or install from the utility script ({PythonHome}\\Scripts directory must be in the system path)

supervisor_service.exe install -c {system-path}\\supervisord.conf

Supervisor for Unix-Like System

Original project for unix-like system


You can view the current Supervisor documentation online in HTML format . This is where you should go for detailed installation and configuration documentation.

Windows specific documentation can be found here.

Mailing list, Reporting Bugs, and Viewing the Source Repository

Please report bugs in the Github issue tracker.

You can view the source repository for supervisor via


If you want to help with the development send a Pull Requests



  • Merge supervisor unix changes from 4.2.2.dev0 (master).

  • Improvements in the execution of the supervisor as a windows service.

  • Support for sending signals for windows application.

  • Improvements to service logs.


  • Merge supervisor unix changes from 4.2.2.dev0 (master).

  • Improvements in the installation of the windows service.

  • Corrections in writing to the windows service log.

  • Bug fix when the ‘directory’ option of a process has quotes.

  • Adding xmlrpc_timeout configuration to supervisorctl.


  • Merge supervisor unix changes from 4.2.0.dev0 (master)

  • Support for web servers that supports shared socket (fastcgi).

  • Support for sending Windows signals. (signal CTRL_C_EVENT|CTRL_BREAK_EVENT)

  • Possibility to configure a custom service name (options: ‘–service-name’ or ‘–service-display-name’).


  • Merge supervisor unix changes from 4.2.0.dev0 (master)

  • Stop process group with task taskkill

  • Fixing service data output issues


  • Merge supervisor unix changes from 4.2.0.dev0 (master)

  • Fixed data output via eventlisterner


  • Merge supervisor unix changes from v4.1.0.dev0 (master)



  • Process restart correction

  • Fixed DeprecationWarning: Parameters to load are deprecated. Call .resolve and .require separately. on setuptools >= 11.3.


  • Bug fixes (covered by unit tests).

  • Supervisor installation script as a service.

  • python -m install -c “{path}supervisord.conf”

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

supervisor-win-4.7.0.tar.gz (397.3 kB view hashes)

Uploaded Source

Built Distribution

supervisor_win-4.7.0-py2.py3-none-any.whl (304.0 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page