# Install supervisor with Homebrew, apk, apt, dnf, pacman, zypper

Process Control System. Version 4.3.0 via Homebrew; verified 2026-07-04.

## Install

```sh
sudo av install brew:supervisor
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install supervisor
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add supervisor
```

  Evidence: Alpine Linux edge package indexes: supervisor from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install supervisor
```

  Evidence: Debian stable package indexes: supervisor from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install supervisor
```

  Evidence: Fedora Rawhide package metadata: supervisor from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- pacman (92%):

```sh
sudo pacman -S supervisor
```

  Evidence: Arch Linux sync databases: supervisor from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install supervisor
```

  Evidence: openSUSE Tumbleweed package metadata: supervisor from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:supervisor
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/supervisor>
- **Version:** 4.3.0
- **Source summary:** Process Control System
- **Homepage:** <https://supervisord.org/>
- **Repository:** <https://github.com/Supervisor/supervisor>
- **Upstream docs:** <https://supervisord.org/>
- **License:** BSD-3-Clause-Modification
- **Source archive:** <https://files.pythonhosted.org/packages/a9/b5/37e7a3706de436a8a2d75334711dad1afb4ddffab09f25e31d89e467542f/supervisor-4.3.0.tar.gz>
- **Last updated:** 2026-07-04T13:13:44+09:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- echo_supervisord_conf (cli)
- pidproxy (cli)
- supervisorctl (cli)
- supervisord (cli)
- echo_supervisord_conf (alias)
- pidproxy (alias)
- supervisorctl (alias)
- supervisord (alias)

## Dependencies

- python@3.14

## Install behavior

- Post-install hook: not defined
- Service: declared
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 4.3.0
- Package-manager updated: 2026-07-04
- Local data: ok
- Upstream repository: https://supervisord.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Supervisor is a Python client/server process-control system for Unix-like operating systems. It became a common package-manager install for developers and operators who wanted a simple way to run, restart, and inspect long-running services without writing per-service rc scripts.

### Project history

Supervisor's own changelog traces public 1.0-era releases back to 2004, followed by 2.x releases in 2006 and a long 3.0 alpha/beta series beginning in 2007 before Supervisor 3.0 in 2013. The project later added Python 3 support in the 4.0.0 release in 2019 while retaining the familiar supervisord/supervisorctl model.

### Adoption history

The official introduction says Supervisor has been around for years and is already used on many servers. The supplied package-manager facts show broad packaging across Homebrew, Debian, Ubuntu, Fedora, Arch, Nix, apk, and openSUSE, which matches its role as a standard Unix service-management utility.

### How it is used

Supervisor runs child processes under supervisord and exposes control through supervisorctl, XML-RPC, and an optional web interface. Its documented value is convenience, accurate process state, limited delegation, and process grouping, especially for services that do not daemonize or restart themselves cleanly.

### Why package nerds care

Package nerds care about Supervisor because it is a classic glue package: small commands, a predictable INI config file, Unix socket/HTTP control surfaces, and deployment patterns that appear in development boxes, servers, containers, and legacy init setups. It is also a good example of Python infrastructure software that distributions have carried through major Python runtime transitions.

### Timeline

- 2004: Supervisor 1.0.5 appears in the official changelog
- 2006: Supervisor 2.0 released after a fundamental rewrite
- 2013: Supervisor 3.0 released
- 2016: Supervisor 3.3.0 added /etc/supervisor/supervisord.conf to upstream search paths
- 2019: Supervisor 4.0.0 added Python 3 support
- 2025: Supervisor 4.3.0 released

### Related projects

- Supervisor overlaps culturally with init scripts, daemon supervisors, process managers, and service managers such as systemd, runit, daemontools-style tools, and container entrypoint supervisors.

### Sources

- <https://github.com/Supervisor/supervisor/blob/main/CHANGES.rst>
- <https://github.com/Supervisor/supervisor/blob/main/README.rst>
- <https://supervisord.org/configuration.html>
- <https://supervisord.org/introduction.html>
- source_facts.package-manager


## Security Notes

formula declares a Homebrew service.

- **Geiger risk:** orange / medium
- formula declares a Homebrew service


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ../etc/supervisord.conf, ../supervisord.conf, $CWD/supervisord.conf, $CWD/etc/supervisord.conf, /etc/supervisord.conf, /etc/supervisor/supervisord.conf
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** supervisor
- **Aliases:** supervisord
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - supervisor - 4.2.5-3: normalized package name match | Debian stable package indexes: supervisor from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | System for controlling process state | http://supervisord.org/
- Debian apt - supervisor-doc - 4.2.5-3: normalized package name match | Debian stable package indexes: supervisor-doc from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Documentation for a supervisor | http://supervisord.org/
- Ubuntu apt - supervisor - 4.2.5-1: normalized package name match | Ubuntu 24.04 LTS package indexes: supervisor from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | System for controlling process state | http://supervisord.org/
- Ubuntu apt - supervisor-doc - 4.2.5-1: normalized package name match | Ubuntu 24.04 LTS package indexes: supervisor-doc from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Documentation for a supervisor | http://supervisord.org/
- apk - supervisor - 4.3.0-r1: normalized package name match | Alpine Linux edge package indexes: supervisor from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | system for controlling process state under UNIX | http://supervisord.org/
- apk - supervisor-openrc - 4.3.0-r1: normalized package name match | Alpine Linux edge package indexes: supervisor-openrc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | system for controlling process state under UNIX (OpenRC init scripts) | http://supervisord.org/
- apk - supervisor-pyc - 4.3.0-r1: normalized package name match | Alpine Linux edge package indexes: supervisor-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for supervisor | http://supervisord.org/
- dnf - supervisor - 4.2.5-12.fc44: normalized package name match | Fedora Rawhide package metadata: supervisor from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A system for allowing the control of process state on UNIX | http://supervisord.org
- pacman - supervisor - 4.3.0-3: normalized package name match | Arch Linux sync databases: supervisor from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | A system for controlling process state under UNIX | http://supervisord.org
- zypper - supervisor - 4.3.0-1.2: normalized package name match | openSUSE Tumbleweed package metadata: supervisor from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A system for controlling process state under UNIX | http://supervisord.org/


## Related links

- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [daemon](https://www.automicvault.com/pkg/brew/daemon/) - Shares av.db curated category or tags: cli, process-management, system, unix.
- [daemonize](https://www.automicvault.com/pkg/brew/daemonize/) - Shares av.db curated category or tags: cli, process-management, system, unix.
- [detach](https://www.automicvault.com/pkg/brew/detach/) - Shares av.db curated category or tags: cli, daemon, process-management, system, unix.
- [gruyere](https://www.automicvault.com/pkg/brew/gruyere/) - Shares av.db curated category or tags: cli, process-management, python, system.
- [immortal](https://www.automicvault.com/pkg/brew/immortal/) - Shares av.db curated category or tags: cli, daemon, process-management, system, unix.
- [lockrun](https://www.automicvault.com/pkg/brew/lockrun/) - Shares av.db curated category or tags: cli, process-management, system, unix.
- [timelimit](https://www.automicvault.com/pkg/brew/timelimit/) - Shares av.db curated category or tags: cli, process-control, process-management, system, unix.
- [cpulimit](https://www.automicvault.com/pkg/brew/cpulimit/) - Shares av.db curated category or tags: cli, process-management, system.
- [hapless](https://www.automicvault.com/pkg/brew/hapless/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, management, process, process-management, python.
- [supervisor](https://www.automicvault.com/pkg/npm/supervisor/) - Same normalized package name in another local ecosystem.

## Combined YAML source

View the package source record on GitHub. [combined/supervisor.yml](https://github.com/automic-vault/db/blob/main/combined/supervisor.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
