Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

DapperDox

dapperdox.io

  • Free plan
  • Windows
  • Linux
  • Web
  • Self-hosted
7.5 Club score Visit dapperdox.io

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.