---
id: supervisord-dependent-startup
version: "1.4.0"
license: Apache Software License v2
license_treatment: permissive
maintenance: abandoned
---

# supervisord-dependent-startup — A plugin for Supervisor that allows starting up services after dependent services have reached specific states. Based on ordered-startup-supervisord by Jason Corbett

License: permissive · Maintenance: abandoned · Downloads: 214.6K/mo

## What it is and what it does

supervisord-dependent-startup is an event listener plugin for Supervisor that solves the problem of coordinating service startup order when services have dependencies on one another. Supervisor's built-in priority system does not guarantee that a service waits for its dependencies to reach a running state before starting; this plugin fills that gap by listening to process state events and delaying dependent service startup until their prerequisites have reached the states you specify.

You configure it by adding an eventlistener block to your supervisor.conf and then marking services with dependency metadata. A service can declare which other services it depends on and what states those services must reach (running, exited, etc.) before it should start. The plugin does not start service groups directly, only individual services within groups.

Use it for:

- Ensure a database service is fully running before starting application servers that depend on it.
- Delay starting a web application until initialization scripts have completed and exited cleanly.
- Coordinate startup of microservices where later services depend on earlier ones reaching a stable state.
- Manage multi-stage startup sequences where some services must exit (not just run) before others begin.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Supervisor plugin that orchestrates service startup by waiting for dependent services to reach specified states before starting downstream services.

No. The package is abandoned (last release 2019-10-09) and targets Python 2.7 and early Python 3 versions. While it solves a real Supervisor coordination problem and has no known vulnerabilities, the lack of maintenance and uncertain compatibility with modern Python versions make it a risky choice for new projects. Consider whether your Supervisor version and Python environment align with its constraints, or evaluate alternatives.

## Install

pip install supervisord-dependent-startup
uv add supervisord-dependent-startup
poetry add supervisord-dependent-startup

## Installing supervisord-dependent-startup

Before you install: Installation is straightforward with no runtime dependencies. However, the package is abandoned—last release was 2019-10-09, over six years ago. It targets Python 2.7 and early Python 3 versions (3.4–3.7), so compatibility with modern Python may be uncertain.

License in practice: Licensed under Apache Software License v2, a permissive license. You can use, modify, and distribute the package freely, including in commercial projects, provided you include a copy of the license and state any changes.

Quickstart:

pip install supervisord-dependent-startup

Then add to supervisor.conf:
[eventlistener:dependentstartup]
command=python -m supervisord_dependent_startup
autostart=true
autorestart=unexpected
startretries=0
exitcodes=0,3
events=PROCESS_STATE

Configure service dependencies:
[program:child]
dependent_startup=true
autostart=false
dependent_startup_wait_for=parent:running

Requires Supervisor to be installed and running; the plugin runs as an event listener within Supervisor's process model.

Verify before relying:

- Whether the plugin functions correctly with modern Python versions (3.8+) despite classifiers only listing up to 3.7.
- Current compatibility with recent Supervisor releases and whether any breaking changes have occurred since 2019.

## Package facts

- License: Apache Software License v2 (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 214.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

supervisor service dependency startup, ordered process startup supervisor, supervisor event listener dependencies, conditional service startup supervisor, supervisor process state coordination, supervisor-plugin, process-orchestration

[View on SkillFed](https://skillfed.io/packages/supervisord-dependent-startup) · [View on PyPI](https://pypi.org/project/supervisord-dependent-startup/)