# Install dosbox-staging with Homebrew

Modernized DOSBox soft-fork. Version 0.82.2 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:dosbox-staging
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dosbox-staging
```

  Evidence: provider-native install command

## Package facts

- **Package key:** brew:dosbox-staging
- **Package manager:** Homebrew
- **Version:** 0.82.2
- **Source summary:** Modernized DOSBox soft-fork
- **Homepage:** <https://dosbox-staging.github.io/>
- **Repository:** <https://github.com/dosbox-staging/dosbox-staging>
- **Last updated:** 2026-06-18T02:28:56-04:00
- **Generated:** 2026-08-03T00:40:33+00:00

## Executables

- dosbox-staging (alias)

## Install behavior

- Bottle: not available

## Freshness

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

DOSBox Staging is a modern continuation of DOSBox focused on keeping classic DOS games and applications easy to run while updating the codebase, build tooling, documentation, audio/video behavior, and release practices.

### Project history

The project presents itself as a mostly drop-in replacement for older DOSBox versions, with existing configurations expected to keep working while users gain newer features. Its README also documents a deliberate preservation role: upstream DOSBox SVN commits, abandoned fork code, and community patches from Vogons are imported into named branches for reference and maintenance.

DOSBox Staging's public release history on GitHub begins with pre-release artifacts in late 2019 and a 0.75.0 release in May 2020. Since then the project has continued on a regular release cadence while adopting contemporary C++ development infrastructure such as CMake, vcpkg, CI, static analysis, dynamic analysis, clang-format, and unit tests.

### Adoption history

Adoption has been driven by retro-computing users who want DOSBox compatibility with more active maintenance and cross-platform packaging. The project publishes stable builds for Windows, macOS, and Linux on its own website, and Homebrew source facts list packages in apk, Homebrew, Fedora, MacPorts, Nix, Scoop, and winget.

The project also serves migrations from other DOSBox variants: its README directs first-time users and people migrating from other DOSBox variants to the getting-started guide.

### How it is used

Users run dosbox-staging to launch DOS games and applications, mount directories or images, and use a DOSBox-style configuration file. Its appeal is compatibility with existing DOSBox workflows while shipping modern defaults and maintained packages.

For packagers and contributors, DOSBox Staging is notable because it treats old emulator history as source material while maintaining a conventional modern open-source workflow: release builds, development builds, CI, tests, and documented dependencies.

### Why package nerds care

DOSBox Staging matters to package nerds because it is a soft fork that tries to make a beloved emulator easier to ship today. It is less about novelty than about maintainable builds, reproducible packaging, and keeping an important retro-gaming tool alive on current platforms.

The repo's imported SVN, fork, and Vogons patch branches are unusually explicit preservation infrastructure, useful for people tracking how DOSBox variants evolved and where old community patches came from.

### Timeline

- 2019: Public pre-release artifacts appear for version 0.75.0-pre.
- 2020: Version 0.75.0 is released on GitHub.
- 2020s: The project publishes stable builds for Windows, macOS, and Linux and keeps development builds for main-branch commits.
- 2026: The project is preparing the 0.83/0.84 generation with release candidates and alpha releases.

### Related projects

- DOSBox Staging is related to upstream DOSBox, DOSBox SVN, abandoned DOSBox forks imported into its repository, Vogons community patches, and optional ecosystem pieces such as dosbox-staging-ext for dynamically loaded dependencies.

### Sources

- <https://github.com/dosbox-staging/dosbox-staging>
- <https://www.dosbox-staging.org/about/>
- <https://www.dosbox-staging.org/getting-started/>
- <https://api.github.com/repos/dosbox-staging/dosbox-staging/releases?per_page=100>
- <https://formulae.brew.sh/formula/dosbox-staging>


## 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

- Linux: ~/.config/dosbox/dosbox-staging.conf
- macOS: ~/Library/Preferences/DOSBox/dosbox-staging.conf
- Windows: C:\Users\%USERNAME%\AppData\Local\DOSBox\dosbox-staging.conf

## Combined YAML source

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


## Sources

- Nucleus package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation