Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Automatic service restart after updates

Project Description


restarter is a little utility to restart services if referenced objects like executables or shared libraries have changed on disk. The goal is to ensure that all services run current versions of their software. This is important for example after security updates.


restarter takes a pidfile as required argument. If the service is stale, that means there are replaced objects still held in memory, restarter executes the restart command passed via the --restart option:

restarter --restart "/etc/init.d/atd restart" /var/run/

There is also the possibility to speficy a “hard restart” command that is executed if the regular restart command fails.

See the output of restarter --help for a list of all supported options.

Stopped Services

Stopped services are gracefully ignored: restarter does nothing if the pidfile does not exist or the pid referenced therein is not running. This behaviour can be modified with the --fail option. Note that restarter always fails when the service was running but did not come up again after restart.

Release History

0.4.4 (2014-10-10)

  • Add Python 3.3 compatibility.
  • Correct source URL.
  • Correct packaging issues.

0.4.2 (2011-10-25)

  • Ignore trailing lines in pid files as produced by PostgreSQL.

0.4.1 (2011-08-03)

  • Packaging issue: version.txt was not included in source distribution.

0.4 (2011-03-18)

  • Improve error messages.
  • Fix double exception on restart failures.

0.3 (2011-02-16)

  • –exclude/-x specifies mmap’ed objects to ignore.
  • Add a little bit of documentation in README.txt.

0.2 (2011-02-14)

  • Packaging issues.


  • Initial public release.

Release History

This version
History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(8.2 kB) Copy SHA256 Hash SHA256
Source Oct 10, 2014
(14.6 kB) Copy SHA256 Hash SHA256
Source Oct 10, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting