DapperDox
DapperDox is an open-source API documentation generator and server for OpenAPI (Swagger) specifications.
What DapperDox is
DapperDox is an open-source API documentation generator and server for OpenAPI (Swagger) specifications. It combines generated reference pages with guides and diagrams written in GitHub Flavoured Markdown. Multiple specifications can appear as a cross-referenced product suite, while Markdown overlays add material to generated API, method and resource pages. A built-in API explorer lets readers try calls from the documentation and supports configurable authentication credentials. DapperDox can proxy paths to services such as sign-on and API key management, and offers multiple themes or custom themes. The getting-started guide describes rendering an OpenAPI Swagger 2.0 specification, downloading a release and serving documentation locally on port 3123. 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 navigation. Proxying between HTTP and HTTPS is supported, with mixed-content cautions for HTTPS sites calling HTTP services.
Good
- Open-source and self-hosted
- Combines references with Markdown guides
- Supports multiple API specifications
- Includes an interactive API explorer
- Offers proxying and custom themes
Watch out
- Swagger 2.0 is the documented format
- Guide navigation defaults to two levels
- HTTPS-to-HTTP proxying can create mixed content
- Requires local installation for self-hosting
Who it suits
It suits API documentation authors and developer teams that need generated references alongside written guides. Self-hosted users on Linux or Windows can run the local server.
Verdict
DapperDox brings OpenAPI references, authored guides, interactive exploration and proxying into one documentation server. Its documented specification and navigation limits should be checked against your documentation structure.
The facts
Each one read from DapperDox's own pages, with the date it was checked.
What it does
- API explorer
- Its built-in API explorer supports experimentation from documentation pages and can integrate with an API’s authentication model.checked 8 Oct 2026
- Configuration
- Configuration parameters can be supplied on the command line or through environment variables.checked 8 Oct 2026
- 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.checked 8 Oct 2026
- Content overlays
- Markdown overlay files can add content to generated API, method, and resource reference pages.checked 8 Oct 2026
- Deployment
- DapperDox serves reference documentation locally on port 3123 by default.checked 8 Oct 2026
- Documented limitation
- By default, guide navigation supports two directory levels; metadata can be used to control navigation for deeper guide directories.checked 8 Oct 2026
- Guides and diagrams
- It combines API specifications with guides and diagrams authored in GitHub Flavoured Markdown.checked 8 Oct 2026
- Installation
- The getting-started guide describes downloading and unpacking a release, then running DapperDox to serve documentation locally.checked 8 Oct 2026
- Intended users
- The maker says DapperDox was created by API documentation authors to improve the quality and usability of documentation for other developers.checked 8 Oct 2026
- Markdown guides
- It combines API reference pages with guides authored in GitHub Flavoured Markdown.checked 8 Oct 2026
- Multiple specifications
- It can document multiple API specifications as a suite and cross-reference them.checked 8 Oct 2026
- Operating systems
- The getting-started guide gives a Windows batch-script example and instructs users to download a release for their operating system.checked 8 Oct 2026
- Proxying
- DapperDox can proxy URL paths to other services, including services for sign-on and API key management.checked 8 Oct 2026
- Proxy integration
- DapperDox can proxy URL paths to other services, including services for user sign-on and API key management.checked 8 Oct 2026
- Purpose
- DapperDox is an open-source API documentation generator and server for OpenAPI (Swagger) specifications.checked 8 Oct 2026
- Secure connections
- The proxy can connect between HTTP and HTTPS, and the guide cautions about mixed content when serving HTTPS while proxying to HTTP.checked 8 Oct 2026
- Specification format
- The getting-started guide describes rendering an OpenAPI Swagger 2.0 specification.checked 8 Oct 2026
- Specification limitation
- When documenting guides, the default navigation enforces a maximum depth of two levels unless navigation metadata is used to control it.checked 8 Oct 2026
- Specification support
- The getting-started guide describes rendering an OpenAPI Swagger 2.0 specification.checked 8 Oct 2026
- Themes
- The product overview says users can choose from multiple themes or create their own.checked 8 Oct 2026
