Register custom domains for apps

You may register a custom domain for your application hosted on STACKIT Cloud Foundry.

As an org manager, you are able to create a private domain within an organization.
You can use your own custom domain or one of our free shared domains:

• *.runs.onstackit.cloud
• *.stackit.gg
• *.stackit.rocks
• *.stackit.run
• *.stackit.zone

1. Make sure that the DNS record for your custom domain points to our load balancer.

   You can do so by creating a ALIAS DNS record pointing to console.apps.01.cf.eu01.stackit.cloud. in order to reach the STACKIT Cloud Foundry load balancer (please copy the value exactly as written).

   This is necessary for the SSL certificate generation to start.

2. Use the following command:

   $ cf create-private-domain <ORG> <DOMAIN>

   For example: $ cf create-private-domain myorg myapp.my-domain.com

3. Map your new custom domain as a route to an application:

   $ cf map-route <APP_NAME> <DOMAIN>

   For example: $ cf map-route myapp myapp.my-domain.com

For all new routes with custom domains, the corresponding SSL certificate generation will run each hour each workday (Monday–Friday).

Please note that this process may take some time depending on external factors. It may take up to three hours for your custom SSL certificate to be available. If you access your domain before the process is finished you might receive an error message in the web browser, since the fallback certificate from the shared apps domain is used temporarily. This error message will disappear as soon as the process is finished.

If you have questions concerning the provisioning of SSL certificates, you can open a ticket here.