ConfigDN

Open source configuration management and feature flags.

Hosted Version

There is a hosted version of ConfigDN available. This is a fully functional version of ConfigDN, hosted by us. We plan to charge for this in the future to help fund development, but for now it is free.

Requirements

• Node.js (Recommended: LTS or newer)
• NPM
• Go 1.27+

Building the project

To build the project, use the build script:

./build.sh

The UI determines whether it is hosted or self-hosted at runtime from the hostname. Only configdn.com receives the hosted branding and legal links; other hostnames receive the self-hosted branding.

This script also builds the UI before a release. Alternatively, you can download a release from the releases page.

Running the project

To run the project, execute the executable built by the build script:

./ConfigDN serve

ConfigDN will then be available at:

• http://localhost:8090/ - UI
• http://localhost:8090/_/ - Admin UI

Creating an admin account

For security, admin accounts must be created from the server command line rather than from the remotely accessible admin UI. Run this from the directory containing the ConfigDN executable:

./ConfigDN superuser create <username> password

Replace <username> with an email address and password with a strong password. If the server uses a different PocketBase data directory, specify the same directory used by the server:

./ConfigDN --dir ./pb_data superuser create admin@example.com 'use-a-strong-password'

You can then sign in at https://your-domain.example/_/.

If you want a prettier interface for resetting passwords, you'll need to go into the admin UI, go to the settings icon then mail settings and update the action URL for reset password to {APP_URL}/auth/reset-password/{TOKEN}. You should probably set up an SMTP server while you're there and check over the other settings to make sure you're happy with them.