Custom Domains

🚧

Quick navigation

Jump to: 1. Request a custom Orka domain | 2. Configure your VPN connection | 3. Use the custom domain in your day-to-day work

You can use a custom domain (such as company.orka.app) to access your Orka environment instead of the default Orka endpoints (10.221.188.20 or 10.221.188.20).

Custom Orka domains provide improved security. They are TLS-enabled and require access via HTTPS.

1. Request a custom Orka domain

Custom Orka domain is available by default. See how to use it in your day-to-day work

📘

IMPORTANT

To switch to a custom Orka domain with versions before 1.5.0, contact the MacStadium team and request a custom domain for your cluster.

2. Configure your VPN connection

If you're using OpenConnect to access your Orka cluster via VPN, you need to add a DNS server to your network configuration.

If you're using Cisco AnyConnect on macOS or Linux, you're already set and you don't need to make any changes. If you're using Cisco AnyConnect on Windows, you need to add a DNS server.

3. Use the custom domain in your day-to-day work

1. If you don't know what your custom domain is, complete the following:

   1. Log into your MacStadium account.
   2. Go to Subscriptions (from the top right corner) and select your Orka cluster.
   3. In the Subscription & Plan details, find your custom domain at the bottom. If you don't see a custom domain field, it's not enabled for your environment yet. See how to request a custom Orka domain

2. With your custom domain enabled, complete the following:

   • For the Orka API, change your API requests to target https://<orka-custom-domain>.
   • For the Orka CLI, run orka config and change the URL setting to https://<orka-custom-domain>.
   • For the Orka Web UI, open https://<orka-custom-domain> in your browser.
   • For CI/CD integrations, switch to https://<orka-custom-domain> in the respective plugin configuration.

You need to use https with your custom domain.

👍

TIP

You can use your Orka API endpoint (http://10.221.188.20 or http://10.221.188.100) and your custom Orka domain (https://company.orka.app) interchangeably in your workflows.