# Install man-db with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

Unix documentation system. Version 2.13.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:man-db
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install man-db
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install man-db
```

  Evidence: MacPorts ports tree: textproc/man-db/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add man-db
```

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

- Debian apt (92%):

```sh
sudo apt install man-db
```

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

- dnf (92%):

```sh
sudo dnf install man-db
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#man-db
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ma/man-db/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S man-db
```

  Evidence: Arch Linux sync databases: man-db from https://geo.mirror.pkgbuild.com/core/os/x86_64/core.db.tar.gz

- zypper (92%):

```sh
sudo zypper install man
```

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

## Package facts

- **Package key:** brew:man-db
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/man-db>
- **Version:** 2.13.1
- **Source summary:** Unix documentation system
- **Homepage:** <https://man-db.gitlab.io/man-db/>
- **Repository:** <https://gitlab.com/man-db/man-db>
- **Upstream docs:** <https://gitlab.com/man-db/man-db/-/tree/main/manual>
- **License:** GPL-2.0-or-later
- **Source archive:** <https://download.savannah.gnu.org/releases/man-db/man-db-2.13.1.tar.xz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- accessdb (cli)
- catman (cli)
- gaccessdb (cli)
- gapropos (cli)
- gcatman (cli)
- glexgrog (cli)
- gman (cli)
- gman-recode (cli)
- gmandb (cli)
- gmanpath (cli)
- gwhatis (cli)
- lexgrog (cli)
- mandb (cli)
- accessdb (alias)
- catman (alias)
- gaccessdb (alias)
- gapropos (alias)
- gcatman (alias)
- glexgrog (alias)
- gman (alias)
- gman-recode (alias)
- gmandb (alias)
- gmanpath (alias)
- gwhatis (alias)
- lexgrog (alias)
- mandb (alias)

## Dependencies

- groff
- libpipeline

## Build dependencies

- pkgconf

## Install behavior

- Post-install hook: not defined
- Caveats: Commands also provided by macOS have been installed with the prefix "g". If you need to use these commands with their normal names, you can add a "bin" directory to your PATH from your bashrc like: PATH="$HOMEBREW_PREFIX/opt/man-db/libexec/bin:$PATH"
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.13.1
- Local data: ok
- Upstream repository: https://man-db.gitlab.io/man-db/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

man-db is an implementation of the standard Unix manual-page system accessed through `man`. Its official homepage describes it as using an indexed database instead of traditional flat-text whatis databases, with utilities such as `man`, `mandb`, `apropos`, and `whatis` around that database.

### Project history

The man-db source tree carries copyright lines going back to John W. Eaton in 1990-1991, Graeme W. Wilford, Fabrizio Polacco, and later Colin Watson. The README identifies Colin Watson as current maintainer and points users to the manual for configuration and formatter details.

man-db's development reflects the long transition from historical Unix man-page lookup toward database-backed indexing. Its configuration and cache model track Filesystem Hierarchy Standard paths such as `/usr/share` for manual pages and `/var/cache/man` for cached cat pages, while preserving compatibility with older FSSTND layouts.

### Adoption history

The official man-db homepage lists use by several GNU/Linux distributions, including Arch Linux, Debian, Dragora, Fedora, Gentoo, openSUSE, and Ubuntu, and notes that it also compiles and runs on a number of proprietary Unix systems.

In package-manager culture, man-db is one of the packages users notice during installs and upgrades because `mandb` updates the manual-page index. It is infrastructure rather than an application: distributions depend on it to make `man`, `apropos`, and `whatis` fast and searchable.

### How it is used

`mandb` initializes or manually updates index database caches, and the stored information is used by man-db utilities to improve speed and functionality. `manpath` computes manual search paths using the man-db configuration file and the user's environment.

The upstream documentation points packagers and builders to `./src/man_db.conf` and `man/man5/manpath.5` for configuration details. Installed paths depend on `sysconfdir`, while the upstream `manpath` manual documents `~/.manpath` as the default user configuration for `manpath -C`.

### Why package nerds care

man-db is important to package nerds because it turns scattered manual pages from every installed package into a searchable local index. Its post-install hooks, cache ownership choices, setuid options, compression support, and path mapping influence how documentation behaves across a whole system.

It is also a classic distribution-integration package: the upstream tarball has defaults, but Linux distributions commonly patch paths or integrate it with package triggers, tmpfiles cleanup, and policy around `/usr/share/man` and `/var/cache/man`.

### Timeline

- 1990: Early man-db copyright lineage begins with John W. Eaton.
- 2001: README notes FHS manual roots `/usr/share` and `/var/cache/man` as current defaults for manual and cat hierarchies.
- 2020: GitLab project creation records the modern GitLab project presence.
- 2022: NEWS notes the Git repository transfer to https://gitlab.com/man-db/man-db.
- 2025: man-db 2.13.1 was released with formatting, portability, and build fixes.

### Related projects

- man-db is related to traditional Unix `man`, `apropos`, `whatis`, `catman`, and `makewhatis` implementations.
- It also depends on formatter tools such as groff or compatible nroff/troff implementations, and it is often compared with mandoc on systems that can use either as the manual-page viewer/searcher.

### Sources

- <https://gitlab.com/man-db/man-db>
- <https://gitlab.com/man-db/man-db/-/raw/main/NEWS.md>
- <https://gitlab.com/man-db/man-db/-/raw/main/README.md>
- <https://gitlab.com/man-db/man-db/-/raw/main/man/man1/manpath.man1>
- <https://gitlab.com/man-db/man-db/-/raw/main/man/man5/manpath.man5>
- <https://gitlab.com/man-db/man-db/-/raw/main/src/man_db.conf.in>
- <https://man-db.nongnu.org/>


## 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: ${sysconfdir}/man_db.conf, ~/.manpath
## Source Database Details

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

## Other Package-Manager Records

- Debian apt - man-db - 2.13.1-1: normalized package name match | Debian stable package indexes: man-db from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | tools for reading manual pages | https://man-db.gitlab.io/man-db/
- Nix - man-db: normalized package name match | nixpkgs package indexes: pkgs/by-name/ma/man-db/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - man-db - 2.12.0-4build2: normalized package name match | Ubuntu 24.04 LTS package indexes: man-db from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | tools for reading manual pages | https://man-db.gitlab.io/man-db/
- apk - man-db - 2.13.1-r1: normalized package name match | Alpine Linux edge package indexes: man-db from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | The man command and related utilities for examining on-line help files | https://man-db.gitlab.io/man-db/
- apk - man-db-doc - 2.13.1-r1: normalized package name match | Alpine Linux edge package indexes: man-db-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | The man command and related utilities for examining on-line help files (documentation) | https://man-db.gitlab.io/man-db/
- apk - man-db-lang - 2.13.1-r1: normalized package name match | Alpine Linux edge package indexes: man-db-lang from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Languages for package man-db | https://man-db.gitlab.io/man-db/
- apk - man-db-systemd - 2.13.1-r1: normalized package name match | Alpine Linux edge package indexes: man-db-systemd from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | The man command and related utilities for examining on-line help files (systemd files) | https://man-db.gitlab.io/man-db/
- dnf - man-db - 2.13.1-3.fc44: normalized package name match | Fedora Rawhide package metadata: man-db from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Tools for searching and reading man pages | http://www.nongnu.org/man-db/
- dnf - man-db-cron - 2.13.1-3.fc44: normalized package name match | Fedora Rawhide package metadata: man-db-cron from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Periodic update of man-db cache | http://www.nongnu.org/man-db/
- pacman - man-db - 2.13.1-1: normalized package name match | Arch Linux sync databases: man-db from https://geo.mirror.pkgbuild.com/core/os/x86_64/core.db.tar.gz | A utility for reading man pages | https://gitlab.com/man-db/man-db
- zypper - man - 2.13.1-7.1: normalized package name match | openSUSE Tumbleweed package metadata: man from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | A Program for Displaying man Pages | https://savannah.nongnu.org/projects/man-db
- MacPorts - man-db: normalized package name match | MacPorts ports tree: textproc/man-db/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## 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.
- [Documentation packages](https://www.automicvault.com/pkg/documentation-tools/) - Matched documentation, manual, or publishing metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [groff](https://www.automicvault.com/pkg/brew/groff/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [mandoc](https://www.automicvault.com/pkg/brew/mandoc/) - Shares av.db curated category or tags: cli, documentation, man-pages, manual-pages, system.
- [man2html](https://www.automicvault.com/pkg/brew/man2html/) - Shares av.db curated category or tags: cli, documentation, man-pages, manual-pages, system.
- [bash](https://www.automicvault.com/pkg/brew/bash/) - Shares av.db curated category or tags: cli, system, unix.
- [bork](https://www.automicvault.com/pkg/brew/bork/) - Shares av.db curated category or tags: cli, system, unix.
- [cups](https://www.automicvault.com/pkg/brew/cups/) - Shares av.db curated category or tags: cli, system, unix.
- [daemon](https://www.automicvault.com/pkg/brew/daemon/) - Shares av.db curated category or tags: cli, system, unix.
- [daemonize](https://www.automicvault.com/pkg/brew/daemonize/) - Shares av.db curated category or tags: cli, system, unix.
- [daemontools](https://www.automicvault.com/pkg/brew/daemontools/) - Shares av.db curated category or tags: cli, system, unix.
- [timelimit](https://www.automicvault.com/pkg/brew/timelimit/) - Local package facts share a topical domain. Shared terms: cli, system, unix.

## Combined YAML source

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