# Install groff with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, zypper

GNU troff text-formatting system. Version 1.24.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:groff
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install groff
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install groff
```

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

### Linux

- apk (92%):

```sh
sudo apk add groff
```

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

- Debian apt (92%):

```sh
sudo apt install groff
```

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

- dnf (92%):

```sh
sudo dnf install groff
```

  Evidence: Fedora Rawhide package metadata: groff 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#groff
```

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

- pacman (92%):

```sh
sudo pacman -S groff
```

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

- zypper (92%):

```sh
sudo zypper install groff
```

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

## Package facts

- **Package key:** brew:groff
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/groff>
- **Version:** 1.24.1
- **Source summary:** GNU troff text-formatting system
- **Homepage:** <https://www.gnu.org/software/groff/>
- **Repository:** <https://git.savannah.gnu.org/git/groff.git>
- **Upstream docs:** <https://www.gnu.org/software/groff>
- **License:** GPL-3.0-or-later
- **Source archive:** <https://ftpmirror.gnu.org/gnu/groff/groff-1.24.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- addftinfo (cli)
- afmtodit (cli)
- chem (cli)
- eqn (cli)
- eqn2graph (cli)
- gdiffmk (cli)
- glilypond (cli)
- gperl (cli)
- gpinyin (cli)
- grap2graph (cli)
- grn (cli)
- grodvi (cli)
- groff (cli)
- grog (cli)
- grolbp (cli)
- grolj4 (cli)
- gropdf (cli)
- grops (cli)
- grotty (cli)
- hpftodit (cli)
- indxbib (cli)
- lkbib (cli)
- lookbib (cli)
- mmroff (cli)
- neqn (cli)
- nroff (cli)
- pdfmom (cli)
- pfbtops (cli)
- pic (cli)
- pic2graph (cli)
- post-grohtml (cli)
- pre-grohtml (cli)
- preconv (cli)
- refer (cli)
- soelim (cli)
- tbl (cli)
- tfmtodit (cli)
- troff (cli)
- addftinfo (alias)
- afmtodit (alias)
- chem (alias)
- eqn (alias)
- eqn2graph (alias)
- gdiffmk (alias)
- glilypond (alias)
- gperl (alias)
- gpinyin (alias)
- grap2graph (alias)
- grn (alias)
- grodvi (alias)
- groff (alias)
- grog (alias)
- grolbp (alias)
- grolj4 (alias)
- gropdf (alias)
- grops (alias)
- grotty (alias)
- hpftodit (alias)
- indxbib (alias)
- lkbib (alias)
- lookbib (alias)
- mmroff (alias)
- neqn (alias)
- nroff (alias)
- pdfmom (alias)
- pfbtops (alias)
- pic (alias)
- pic2graph (alias)
- post-grohtml (alias)
- pre-grohtml (alias)
- preconv (alias)
- refer (alias)
- soelim (alias)
- tbl (alias)
- tfmtodit (alias)
- troff (alias)

## Dependencies

- ghostscript
- netpbm
- psutils
- uchardet

## Build dependencies

- pkgconf
- texinfo

## Uses from macOS

- perl

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.24.1
- Local data: ok
- Upstream repository: https://www.gnu.org/software/groff/
- info: No package-manager update timestamp was available.
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

GNU groff is the GNU implementation of the roff/troff document formatting system. It is one of the quiet infrastructure packages of Unix-like systems: a typesetting suite, a macro and preprocessor ecosystem, and the historical engine behind a large share of manual-page formatting.

### Project history

groff belongs to the roff family that began with early Unix text formatting. The GNU manual places it in the line of roff, nroff, and troff: plain text mixed with formatting requests is processed into terminal, printer, PostScript, PDF, HTML, or DVI output. GNU describes groff as a reimplementation and extension of troff and related AT&T Unix programs.

The package was written primarily by James Clark as the GNU replacement for proprietary Unix troff/nroff tooling. GNU's own distribution archive records early public source releases in 1991 and later tarball history across the 1990s, while the project homepage identifies the Savannah Git repository as the development source.

Over time groff became much more than the `troff` formatter. The package includes preprocessors and helpers such as `eqn`, `tbl`, `pic`, `refer`, `soelim`, `grn`, `chem`, `grog`, and output drivers such as `grops`, `gropdf`, `grohtml`, `grodvi`, and `grotty`. Its macro packages let users write manual pages, memoranda, papers, books, and technical documents without adopting a WYSIWYG editor.

Maintenance also reflects a long-lived GNU package rather than a short utility. The GNU homepage lists G. Branden Robinson as maintainer and Bertrand Garrigues and Werner Lemberg as maintainers emeriti. GNU mailing-list announcements document continuing release work, including the 1.23.0 announcement after years of accumulated documentation, man-page, and code changes.

### Adoption history

groff's adoption came from Unix documentation culture. GNU states that groff is widely available on POSIX and other systems because of its long association with Unix manuals, including man pages. On many Linux systems, `man` pipelines historically depended on groff or compatible roff tooling to render installed manual pages.

Distribution packaging made groff ordinary infrastructure: sometimes installed as part of a base system, sometimes split into runtime, documentation, debug, or full packages. The GNU homepage explicitly notes that many GNU/Linux distributions offer groff source and binary packages and may subdivide the installation.

The package also carried older document workflows forward. GNU notes that groff and its predecessor produced several best-selling software engineering texts, and the manual documents workflows that combine low-level requests, macro packages, preprocessors, and output drivers.

### How it is used

The usual CLI pattern is a pipeline hidden behind `groff`: preprocessors such as `tbl`, `eqn`, `pic`, or `refer` transform input, `troff` formats it, and a postprocessor targets a terminal, PostScript, PDF, HTML, DVI, or printer format. The `grog` helper can inspect a document and suggest the needed `groff` options.

For everyday package users, groff is most often noticed through `man`, `nroff`, and manual-page macros rather than as a book-production system. For document authors, it remains a programmable text formatting tool where source files are plain text and outputs are generated reproducibly.

Unlike many CLI tools in this batch, groff has no normal per-user credentials and no single project config file. Its behavior is driven by command-line options, macro files, font/devices data, and documents being formatted.

### Why package nerds care

groff is package-nerd bedrock. It is a GNU package that exists because Unix documentation is source code too: plain text inputs, macros, preprocessors, build rules, and deterministic outputs. Removing or replacing it affects not one app but the documentation pipeline of an operating system.

It also explains why package manifests sometimes contain a surprising pile of tiny executables. `groff` is a suite with historical Unix tool boundaries preserved: separate commands for tables, equations, pictures, bibliographies, device conversion, and terminal output.

The package is especially relevant to Homebrew and Unix-like packaging because macOS and BSD systems have had different relationships with groff and mandoc over time. Installing GNU groff gives users the GNU roff toolchain even on platforms where the base system uses a smaller man-page-focused formatter.

### Timeline

- 1970s: roff, nroff, and troff became part of early Unix document preparation culture.
- 1980s: ditroff and related preprocessors shaped the model that groff later reimplemented and extended.
- 1991-06-02: GNU's archive records groff 1.02 source distribution.
- 1991-11-17: GNU's archive records groff 1.04 source distribution.
- 1990s: groff became the GNU replacement for proprietary Unix troff/nroff implementations across free Unix-like systems.
- 2001: GNU announced groff 1.17 on the info-gnu mailing list.
- 2018-12 to 2023-07: The 1.23.0 announcement summarized years of work since 1.22.4, including thousands of commits and extensive manual-page updates.
- 2026: GNU's project page documented groff 1.24.1 and the Savannah Git repository as the development source.

### Related projects

- AT&T Unix troff, nroff, roff, and ditroff are groff's historical predecessors.
- mandoc is a related man-page-focused formatter used by some BSD-derived systems.
- TeX is the other major historical plain-text typesetting ecosystem often compared with roff-family tools.
- GNU Texinfo overlaps with groff in the broader GNU documentation toolchain.
- man-db and similar manual-page viewers commonly invoke roff-compatible formatters.

### Sources

- <https://ftp.gnu.org/gnu/groff/old/>
- <https://git.savannah.gnu.org/git/groff.git>
- <https://lists.gnu.org/archive/html/info-gnu/2023-07/msg00001.html>
- <https://www.gnu.org/software/groff/>
- <https://www.gnu.org/software/groff/manual/groff.html>


## Security Notes

narrow executable package without higher-risk signals.

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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** groff
- **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 - groff - 1.23.0-9: normalized package name match | Debian stable package indexes: groff from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | GNU troff text-formatting system | https://www.gnu.org/software/groff/
- Debian apt - groff-base - 1.23.0-9: normalized package name match | Debian stable package indexes: groff-base from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | GNU troff text-formatting system (base system components) | https://www.gnu.org/software/groff/
- Nix - groff: normalized package name match | nixpkgs package indexes: pkgs/by-name/gr/groff/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - groff - 1.23.0-3build2: normalized package name match | Ubuntu 24.04 LTS package indexes: groff from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | GNU troff text-formatting system | https://www.gnu.org/software/groff/
- Ubuntu apt - groff-base - 1.23.0-3build2: normalized package name match | Ubuntu 24.04 LTS package indexes: groff-base from https://archive.ubuntu.com/ubuntu/dists/noble/main/binary-amd64/Packages.gz | GNU troff text-formatting system (base system components) | https://www.gnu.org/software/groff/
- apk - groff - 1.24.1-r0: normalized package name match | Alpine Linux edge package indexes: groff from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | GNU troff text-formatting system | https://www.gnu.org/software/groff/groff.html
- apk - groff-doc - 1.24.1-r0: normalized package name match | Alpine Linux edge package indexes: groff-doc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | GNU troff text-formatting system (documentation) | https://www.gnu.org/software/groff/groff.html
- dnf - groff - 1.24.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: groff from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A document formatting system | http://www.gnu.org/software/groff/
- dnf - groff-base - 1.24.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: groff-base from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Parts of the groff formatting system required to display manual pages | http://www.gnu.org/software/groff/
- dnf - groff-doc - 1.24.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: groff-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documentation for groff document formatting system | http://www.gnu.org/software/groff/
- dnf - groff-perl - 1.24.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: groff-perl from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Parts of the groff formatting system that require Perl | http://www.gnu.org/software/groff/
- dnf - groff-x11 - 1.24.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: groff-x11 from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Parts of the groff formatting system that require X Windows System | http://www.gnu.org/software/groff/
- pacman - groff - 1.24.1-1: normalized package name match | Arch Linux sync databases: groff from https://geo.mirror.pkgbuild.com/core/os/x86_64/core.db.tar.gz | GNU troff text-formatting system | https://www.gnu.org/software/groff/groff.html
- zypper - groff - 1.23.0-6.2: normalized package name match | openSUSE Tumbleweed package metadata: groff from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | GNU troff Document Formatting System | http://www.gnu.org/software/groff/groff.html
- zypper - soelim-common - 1.23.0-6.2: normalized package name match | openSUSE Tumbleweed package metadata: soelim-common from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Common package for soelim alternatives | http://www.gnu.org/software/groff/groff.html
- MacPorts - groff: normalized package name match | MacPorts ports tree: sysutils/groff/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.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [ghostscript](https://www.automicvault.com/pkg/brew/ghostscript/) - Runtime dependency declared by Homebrew.
- [netpbm](https://www.automicvault.com/pkg/brew/netpbm/) - Runtime dependency declared by Homebrew.
- [psutils](https://www.automicvault.com/pkg/brew/psutils/) - Runtime dependency declared by Homebrew.
- [uchardet](https://www.automicvault.com/pkg/brew/uchardet/) - Runtime dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [texinfo](https://www.automicvault.com/pkg/brew/texinfo/) - Build dependency declared by Homebrew.
- [cppman](https://www.automicvault.com/pkg/brew/cppman/) - Popular package that depends on this formula.
- [man-db](https://www.automicvault.com/pkg/brew/man-db/) - Popular package that depends on this formula.
- [qman](https://www.automicvault.com/pkg/brew/qman/) - Popular package that depends on this formula.
- [enscript](https://www.automicvault.com/pkg/brew/enscript/) - Shares av.db curated category or tags: cli, developer-tools, gnu, text-processing.
- [gawk](https://www.automicvault.com/pkg/brew/gawk/) - Shares av.db curated category or tags: cli, developer-tools, gnu, text-processing.
- [grep](https://www.automicvault.com/pkg/brew/grep/) - Shares av.db curated category or tags: cli, developer-tools, gnu, text-processing.
- [wdiff](https://www.automicvault.com/pkg/brew/wdiff/) - Shares av.db curated category or tags: cli, developer-tools, gnu, text-processing.
- [align](https://www.automicvault.com/pkg/brew/align/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.
- [bsdconv](https://www.automicvault.com/pkg/brew/bsdconv/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.
- [cconv](https://www.automicvault.com/pkg/brew/cconv/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.
- [cmigemo](https://www.automicvault.com/pkg/brew/cmigemo/) - Shares av.db curated category or tags: cli, developer-tools, text-processing.

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- 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
