Dev Mode

dev-mode.conf contains settings that are only relevant in local development and testing environments. This file is only loaded when the dev-mode feature is explicitly enabled in _features.conf.

Fields

enableDidWebResolverHttps

Boolean — default: true

Controls whether the DID Web resolver enforces HTTPS. When true, only HTTPS DID Web endpoints are accepted. Set to false in local development environments where HTTPS is not available.

This field has no effect unless the dev-mode feature is enabled in _features.conf.

The code default is true (HTTPS enforced). The example dev-mode.conf shipped in the repository sets this to false, which is the typical local development value. If you enable dev-mode but do not provide a dev-mode.conf, HTTPS will be enforced.

Example

dev-mode.conf
# Allow HTTP for local DID Web resolution (typical dev setup)
enableDidWebResolverHttps = false

Enabling Dev Mode

Add dev-mode to the enabledFeatures list in _features.conf. The dev-mode.conf file is only loaded when this feature is active — it has no effect otherwise.

_features.conf
enabledFeatures = [
    dev-mode
]
Last updated on May 18, 2026