6.2. Hostname configuration

This page is for operators and describes how to configure custom domains and subdomains to integrate Nubus into your existing infrastructure.

Nubus uses subdomains to expose different services. By default, Nubus uses the following subdomains:

• Portal: portal.<global.domain>

• Keycloak: id.<global.domain>

6.2.1. Customize global domain

Nubus requires the global.domain setting to function correctly. It constructs all service URLs using this domain combined with their respective subdomains. For information where to configure it, see Deploy dependencies based on examples included in Nubus.

6.2.2. Customize subdomains

To use custom subdomains instead of the default settings, such as portal and id, set your values similar to the example in Listing 6.3 in your custom_values.yaml values file. The example results in the following subdomain configuration:

• my-portal.example.com

• my-id.example.com

After updating your configuration, apply the changes as described in Apply configuration.

Listing 6.3 Custom subdomain configuration

global:
  domain: "example.com"
  subDomains:
    portal: "my-portal"
    keycloak: "my-id"

See also

global.subDomains.portal

Configuration reference for the portal subdomain.

global.subDomains.keycloak

Configuration reference for the Keycloak subdomain.