Skip to main content

Tools for communicating with runit / daemontools supervisors.

Project description

This module provide a methods to handle runit or daemontools based supervised services, using the control file provided. Here is a small example:

>>> import supervise
>>> s = supervise.Service('test')
>>> print s.status()
{'action': None, 'status': 0, 'uptime': 300L, 'pid': None}
>>> s.start()
>>> print s.status()
{'action': None, 'status': 1, 'uptime': 3L, 'pid': 27450}

Read the manpage of runsv(8) for more information. Also read the documentation for ServiceStatus to known how to parse status information.


Last month I needed to install runit in some servers to supervise a couple of services. Unfortunately my management interface cannot handle the services anymore, so I decided to write a small module in python to solve this handicap, and that is the result!.

With this module you can handle in python environment a number of runit scripts. I think that this might be work for daemontools too, but I do not test yet. Let’s see an example:

>>> import supervise
>>> c = supervise.Service("/var/service/httpd")
>>> print s.status()
{'action': 'normal', 'status': 'up', 'uptime': 300L, 'pid': None}
>>> if s.status()['status'] == supervise.STATUS_DOWN: print "service down"
service down
>>> s.start()
>>> if s.status()['status'] == supervise.STATUS_UP: print "service up"
service up

Personally I use this module with rpyc library to manage remotely the services running in a host, but it too easy making a web interface, for example using bottle:

import supervise
import simplejson
from bottle import route, run

def service_status(name):
    return simplejson.dumps( supervise.Service("/var/service/" +
        name).status() )

def service_up(name):
    c = supervise.Service("/var/service/" + name)
    return "OK UP"

def service_down(name):
    c = supervise.Service("/var/service/" + name)
    return "OK DOWN"

if __name__ == "__main__":

Now you can stop your service just only point your browser http://localhost/service/down/httpd (to down http service in this case).


author:Andres J. Diaz <>
maintainer:Peter Ruibal <>

Project details

Download files

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

Files for supervise, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size supervise-1.1.1-py2.6.egg (10.1 kB) File type Egg Python version 2.6 Upload date Hashes View
Filename, size supervise-1.1.1-py2.7.egg (10.1 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size supervise-1.1.1.tar.gz (5.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page