# Install immortal with Homebrew

OS agnostic (*nix) cross-platform supervisor. Version 0.24.6 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:immortal
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install immortal
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:immortal
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/immortal>
- **Version:** 0.24.6
- **Source summary:** OS agnostic (*nix) cross-platform supervisor
- **Homepage:** <https://immortal.run/>
- **Repository:** <https://github.com/immortal/immortal>
- **Upstream docs:** <https://immortal.run/>
- **License:** BSD-3-Clause
- **Source archive:** <https://github.com/immortal/immortal/archive/refs/tags/v0.24.6.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- immortal (cli)
- immortalctl (cli)
- immortaldir (cli)
- immortal (alias)
- immortalctl (alias)
- immortaldir (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.24.6
- Local data: ok
- Upstream repository: https://github.com/immortal/immortal
- Upstream latest detected: v0.24.6 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

immortal is a small Go process supervisor for Unix-like systems. It packages a familiar daemon-management idea into three commands: immortal for running and supervising a service, immortalctl for status and control, and immortaldir for managing services from YAML files.

### Project history

The public GitHub repository was created in 2016 and describes immortal as a cross-platform, OS-agnostic supervisor for the *nix family. The project site presents it as a practical service wrapper with manual pages, packaging links, examples, and a run.yml workflow.

The run.yml documentation shows the project's deployment bias: a service can ship its own YAML file, and operators can stop, restart, pause, or resume it through immortal without logging into the host to hand-run process commands.

### Adoption history

immortal's adoption footprint is modest compared with large init systems, but it is packaged for Homebrew and distributed by the project as Linux deb and rpm artifacts. That puts it in the category of small supervisor tools chosen when systemd, supervisord, or runit is more machinery than a package author wants.

### How it is used

The tool is used to run a command detached from a controlling terminal, restart it after termination, keep logs, and expose status and control through a Unix socket. The companion immortalctl command provides the operator-facing control surface.

### Why package nerds care

For package maintainers, immortal is notable because it is a compact, Go-built supervisor with a YAML file convention and no hard dependency on one init system. It is the sort of utility that fits Homebrew and BSD-style environments where a service wrapper should be inspectable and portable.

### Timeline

- 2016: Public GitHub repository created.
- 2017: Early 0.13.x and 0.15.x releases published through GitHub releases.
- 2024: v0.24.6 published through the GitHub releases feed.

### Related projects

- supervisord, systemd, runit, daemontools, and s6 occupy the neighboring process-supervision space.
- immortalctl and immortaldir are shipped with immortal as the control and directory-management companions.

### Sources

- <https://api.github.com/repos/immortal/immortal/releases>
- <https://formulae.brew.sh/formula/immortal>
- <https://github.com/immortal/immortal>
- <https://immortal.run/>
- <https://immortal.run/post/run.yml/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## 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: /usr/local/etc/immortal/*.yml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** immortal
- **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


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Matched curated package taxonomy and local package facts.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [detach](https://www.automicvault.com/pkg/brew/detach/) - Shares av.db curated category or tags: cli, daemon, process-management, system, unix.
- [supervisor](https://www.automicvault.com/pkg/brew/supervisor/) - Shares av.db curated category or tags: cli, daemon, process-management, system, unix.
- [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.
- [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-management, system, unix.
- [cpulimit](https://www.automicvault.com/pkg/brew/cpulimit/) - Shares av.db curated category or tags: cli, process-management, system.
- [daemontools](https://www.automicvault.com/pkg/brew/daemontools/) - Shares av.db curated category or tags: cli, service-management, system, unix.
- [forever](https://www.automicvault.com/pkg/npm/forever/) - Local package facts share a topical domain. Shared terms: cli, daemon, management, process, process-management.

## Combined YAML source

View the package source record on GitHub. [combined/immortal.yml](https://github.com/automic-vault/db/blob/main/combined/immortal.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
- cross-ecosystem install command graph
