# Install chocolate-doom with Homebrew, apk, apt, dnf, Nix, zypper

Accurate source port of Doom. Version 3.1.1 via Homebrew; verified 2026-06-18. Also installable with debian: sudo apt install chocolate-doom.

## Install

```sh
sudo av install brew:chocolate-doom
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install chocolate-doom
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add chocolate-doom
```

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

- Debian apt (92%):

```sh
sudo apt install chocolate-doom
```

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

- dnf (92%):

```sh
sudo dnf install chocolate-doom
```

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

- Nix (92%):

```sh
nix profile install nixpkgs#chocolate-doom
```

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

- zypper (92%):

```sh
sudo zypper install chocolate-doom
```

  Evidence: openSUSE Tumbleweed package metadata: chocolate-doom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst

## Package facts

- **Package key:** brew:chocolate-doom
- **Package manager:** Homebrew
- **Version:** 3.1.1
- **Source summary:** Accurate source port of Doom
- **Homepage:** <https://www.chocolate-doom.org/>
- **Repository:** <https://github.com/chocolate-doom/chocolate-doom>
- **Last updated:** 2026-06-18T02:28:55-04:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- chocolate-doom (alias)
- chocolate-doom-setup (alias)
- chocolate-heretic (alias)
- chocolate-heretic-setup (alias)
- chocolate-hexen (alias)
- chocolate-hexen-setup (alias)
- chocolate-server (alias)
- chocolate-strife (alias)
- chocolate-strife-setup (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 3.1.1
## Project history and usage

Chocolate Doom is a Doom source port focused on accurately reproducing the original DOS Doom experience on modern systems.

### Project history

The official repository begins in July 2005, and the README says the project originally targeted Doom before expanding to include Heretic, Hexen, and Strife. Its stated goals are free software, portability, accurate DOS behavior including bugs, demo/config/save compatibility, and a retro feel.

### Adoption history

The official wiki presents Chocolate Doom as an actively developed source port with downloads, a user guide, source code, and related forks. The input package facts show broad package-manager availability across Homebrew, Alpine, Debian, Fedora, Nix, Ubuntu, and openSUSE.

### How it is used

Players use the chocolate-doom family of executables with original IWAD files and DOS-compatible configuration. The README documents default.cfg compatibility, the separate chocolate-doom.cfg file for extra settings, setup tools, command-line options, and -merge for total conversions that expected DOS-era IWAD merging.

### Why package nerds care

Chocolate Doom is important in package-manager culture because it is a reference-quality, portability-minded Doom source port: small enough to ship widely, strict enough to preserve vanilla behavior, and useful as a baseline for forks such as Crispy Doom.

### Timeline

- 2005: Initial public repository history and chocolate-doom 0.0.1 tags.
- 2015: 2.2.0 release line appears in official tags.
- 2017: 3.0.0 release arrives after beta tags.
- 2024: 3.1.0 release appears in official tags.
- 2025: 3.1.1 release appears in official tags and Homebrew tracks 3.1.1.

### Related projects

- The README names Doom, Heretic, Hexen, and Strife support. The official wiki links Crispy Doom as a friendly fork that adds extra features.

### Sources

- <https://github.com/chocolate-doom/chocolate-doom#readme>
- <https://www.chocolate-doom.org/wiki/index.php/Chocolate_Doom>
- <https://formulae.brew.sh/api/formula/chocolate-doom.json>
- <https://github.com/chocolate-doom/chocolate-doom>


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal


## 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: SDL_GetPrefPath("", "chocolate-doom")/default.cfg, SDL_GetPrefPath("", "chocolate-doom")/chocolate-doom.cfg
- Windows: ./default.cfg, ./chocolate-doom.cfg
## Other Package-Manager Records

- Debian apt - chocolate-doom - 3.1.0-1: normalized package name match | Debian stable package indexes: chocolate-doom from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Doom engines closely-compatible with Vanilla Doom | https://www.chocolate-doom.org
- Nix - chocolate-doom: normalized package name match | nixpkgs package indexes: pkgs/by-name/ch/chocolate-doom/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - chocolate-doom - 3.0.1+really3.0.0+git1548-1build2: normalized package name match | Ubuntu 24.04 LTS package indexes: chocolate-doom from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Doom engines closely-compatible with Vanilla Doom | https://chocolate-doom.org/
- apk - chocolate-doom - 3.1.1-r0: normalized package name match | Alpine Linux edge package indexes: chocolate-doom from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Portable release of Doom, Heretic, Hexen, and Strife | https://www.chocolate-doom.org
- apk - chocolate-doom-doc - 3.1.1-r0: normalized package name match | Alpine Linux edge package indexes: chocolate-doom-doc from https://dl-cdn.alpinelinux.org/alpine/edge/testing/x86_64/APKINDEX.tar.gz | Portable release of Doom, Heretic, Hexen, and Strife (documentation) | https://www.chocolate-doom.org
- dnf - chocolate-doom - 3.1.1-2.fc45: normalized package name match | Fedora Rawhide package metadata: chocolate-doom from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/07190dc5ae9f35ae73866675fed6d95fe6e8d9fe22c9d7cdf85862cb2ed24a4c-primary.xml.zst | Historically compatible Doom engine | http://chocolate-doom.org/
- zypper - chocolate-doom - 3.1.1-1.6: normalized package name match | openSUSE Tumbleweed package metadata: chocolate-doom from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Conservative DOOM/Heretic/Hexen/Strife source port | http://chocolate-doom.org/


## Combined YAML source

View the package source record on GitHub. [combined/chocolate-doom.yml](https://github.com/mxcl/pkgdb/blob/main/combined/chocolate-doom.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph