Custom Hostnames

FlowFuse allows you to point a custom subdomain at your instances, such as dashboard.example.com.

This feature is available to:

  • FlowFuse Cloud Enterprise teams
  • Self-hosted FlowFuse Enterprise, running version 2.5 or later with the kubernetes driver

Configuring a custom hostname

The Custom Hostname option is available under the General Settings tab of your Instance.

Currently, FlowFuse only supports configuring a subdomain such as dashboard.example.com. Top level domains cannot be used.

  1. Enter your custom subdomain and click save.
  2. You will be shown a dialog to confirm the change, as this will require restarting your Instance to apply. It also provides information on how to configure your DNS provider.
  3. Using your DNS provider, create a CNAME record for your chosen subdomain that points at the endpoint provided in the dialog.

Note: it is important to configure the Instance's Custom Hostname before you make the DNS changes. Making the DNS changes without configuring your Instance may allow someone else to configure their instance to use your subdomain.

For FlowFuse Cloud, the CNAME should point to custom-loadbalancer.flowfuse.com. For self-hosted users, use the information provided in the dialog.

If you also use CAA DNS entries to control which Certificate Authorities can issue certificates for your domains, you will need to add a record allowing LetsEncrypt to issue certificate. Please see details here. The platform will issue certificates using the http-01 validation method.