DapperDox
dapperdox.io
- Free plan
- Windows
- Linux
- Web
- Self-hosted
What DapperDox is
DapperDox is a free, open-source generator and server for API documentation based on OpenAPI (Swagger) specifications. It combines generated API reference pages with guides and diagrams written in GitHub Flavoured Markdown. Multiple specifications can be presented as a cross-referenced product suite, and Markdown overlays can add material to generated API, method, and resource pages. A built-in API explorer lets readers try calls from documentation and supports configurable authentication credentials. DapperDox can proxy URL paths to services such as sign-on and API key management systems. Users can choose from multiple themes or create their own. The getting-started guide covers rendering an OpenAPI Swagger 2.0 specification, downloading a release, and running documentation locally on port 3123 by default. Settings can be supplied through command-line parameters or environment variables. It supports Linux, Windows, web, and self-hosted use. Guide navigation covers two directory levels by default; metadata can control deeper directories. The proxy can connect HTTP and HTTPS, with mixed-content cautions.
Who it suits
DapperDox suits developers and documentation teams publishing OpenAPI references alongside authored guides. It is useful for self-hosted documentation on Linux or Windows.
Good to know, and what to watch
- Combines references with Markdown guides
- Interactive API explorer
- Supports multiple API specifications
- Customizable themes
- Proxy integration for sign-on services
- Swagger 2.0 is the documented specification format
- Guide navigation defaults to two directory levels
- HTTPS-to-HTTP proxying can create mixed content
The verdict
DapperDox brings generated OpenAPI references, explanatory guides, diagrams, and interactive API exploration into one self-hosted server. Its overlays, themes, proxying, and multi-specification support provide control over documentation structure and presentation.
What the maker publishes
- API explorer
- The built-in API explorer lets users experiment with APIs from documentation pages and supports configurable authentication credentials. source
- API explorer
- Its built-in API explorer supports experimentation from documentation pages and can integrate with an API’s authentication model. source
- Configuration
- Configuration parameters can be supplied on the command line or through environment variables. source
- Connection security
- DapperDox can proxy between HTTP and HTTPS, and its documentation cautions about mixed content when serving HTTPS while proxying to an HTTP service. source
- Content overlays
- Markdown overlay files can add content to generated API, method, and resource reference pages. source
- Deployment
- DapperDox serves reference documentation locally on port 3123 by default. source
- Documented limitation
- By default, guide navigation supports two directory levels; metadata can be used to control navigation for deeper guide directories. source
- Guides and diagrams
- It combines API specifications with guides and diagrams authored in GitHub Flavoured Markdown. source
- Installation
- The getting-started guide describes downloading and unpacking a release, then running DapperDox to serve documentation locally. source
- Intended users
- The maker says DapperDox was created by API documentation authors to improve the quality and usability of documentation for other developers. source
- Markdown guides
- It combines API reference pages with guides authored in GitHub Flavoured Markdown. source
- Multiple specifications
- It can document multiple API specifications together as a suite of cross-referenced products. source
- Multiple specifications
- It can document multiple API specifications as a suite and cross-reference them. source
- Operating systems
- The getting-started guide gives a Windows batch-script example and instructs users to download a release for their operating system. source
- Proxying
- DapperDox can proxy URL paths to other services, including services for sign-on and API key management. source
- Proxy integration
- DapperDox can proxy URL paths to other services, including services for user sign-on and API key management. source
- Purpose
- DapperDox is an open-source API documentation generator and server for OpenAPI (Swagger) specifications. source
- Secure connections
- The proxy can connect between HTTP and HTTPS, and the guide cautions about mixed content when serving HTTPS while proxying to HTTP. source
- Specification format
- The getting-started guide describes rendering an OpenAPI Swagger 2.0 specification. source
- Specification limitation
- When documenting guides, the default navigation enforces a maximum depth of two levels unless navigation metadata is used to control it. source
- Specification support
- The getting-started guide describes rendering an OpenAPI Swagger 2.0 specification. source
- Themes
- The product overview says users can choose from multiple themes or create their own. source
Checked against the maker's pages on 8 Oct 2026.