Custom Domains

MacStadium provides on-demand custom TLS-enabled domains. Learn how to enable a custom domain for your cluster and how to work with it.

🚧

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.100 or 10.10.10.100).

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

1. Request a custom Orka domain

To switch to a custom Orka domain, 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.
  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.10.10.100 or http://10.221.188.188) and your custom Orka domain (https://company.orka.app) interchangeably in your workflows.

Updated 4 months ago


Custom Domains


MacStadium provides on-demand custom TLS-enabled domains. Learn how to enable a custom domain for your cluster and how to work with it.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.


© 2019-2020 Copyright MacStadium, Inc. – Documentation built with readme.io. Orka is a registered trademark of MacStadium, Inc.