Skip to main content

Configure the application URL (CLI)

The application URL is the public web address of your deployment, for example https://docs.your-company.com. The app uses it to build the links inside the emails it sends: user invitations, password resets, welcome messages and notifications. If it is not set correctly, those emails go out with links that point at localhost or the wrong host, so recipients cannot click through.

On a self-hosted deployment you set it yourself, live, with no restart and no redeploy. This guide assumes you have already installed and pointed the CLI at your deployment. If not, follow System Administration (CLI) first.

See what is currently set​

da admin config get app.url

The source shown tells you whether the value comes from the settings store (something you set), from an environment variable (the deployment default), or from a built-in default.

Set the application URL​

Use the exact address your users reach the app on, including https://, with no trailing path. The CLI stores it as-is (a trailing slash is trimmed for you):

da admin config set app.url https://docs.your-company.com

The change is live. Every email the app sends picks up the new address on the next send, with no restart and no redeploy. That includes invitations, password resets, welcome emails, the test email, the mobile-capture QR code, and the licensing, changelog and budget notifications.

If your deployment runs several replicas, a change reaches all of them within about 30 seconds (each replica refreshes its copy of the settings on a short timer). If a change does not seem to have taken effect, wait a moment and try again before investigating further.

Confirm it reaches real emails​

Set SMTP first if you have not already (see Configure SMTP), then send yourself a test email and check that the logo and links point at your new address:

da admin config test-email you@your-company.com

Revert the setting​

To drop the value you set and fall back to the deployment default, use unset:

da admin config unset app.url

Troubleshooting​

  • Emails still link to localhost or the wrong host: confirm the stored value with da admin config get app.url, set the correct public address, and send a new test email. On a multi-replica deployment, allow about 30 seconds for the change to reach every replica.
  • The link works but uses http instead of https: set app.url to the full https:// address. The value is used verbatim to build links.

For connection or authentication errors with the CLI itself (401, 403, timeouts), see Troubleshooting the CLI.