Domains

Infrastructure > Network > Domains

Overview

The Domains section is for creating and managing domains for use in Morpheus. Domains are used for setting FQDNs, joining Windows Instances to Domains, and creating A Records with DNS Integrations. The Domains section is also a multi-tenant endpoint for managing domain settings across multiple accounts.

  • Added and synced Domains are available for selection in the Domain dropdown when provisioning an Instance

  • Default domains can be set for Clouds and Networks in their Advanced Options sections.

  • Images can be flagged to Auto-Join Domains in the Provisioning > Virtual Images section

Important

For an Instance to auto-join a Domain, a Domain must set in the Advanced Options section of the Cloud or Network used when provisioning

Adding Domains

  1. Navigate to Infrastructure > Network > Domains

  2. Select + ADD

  3. Enter the following:

    Domain Name

    Ex. demo.example.com

    Description

    Descriptive metadata for use in Morpheus

    Display Name

    Overrides the displayed name in domain selection components, which is useful when using many OU paths

    Public Zone

    Check for Public Zones, leave uncheck for Private Zones

    Workflow

    Select an existing Workflow which will be applied to Instances at provision time when they are associated with the domain. This is useful for any domain-related scripting you may currently use. For example, you may want to ensure a machine is removed from the domain when it’s torn down which could be accomplished by creating a Provisioning Workflow (with teardown phase Tasks) and associating the Workflow with the domain

    Join Domain Controller

    Check to have Windows instances join a Domain Controller

    Username

    Admin user for Domain Controller (in domain/username format)

    Password

    Password for DC user account

    DC Server

    (optional) Specify the URL or Path of the DC Server

    OU Path

    (optional) Enter the OU Path for the connection string.

    Guest Username

    (optional) If set, this will change the Instance RPC Service User after domain join

    Guest Password

    (optional) The password for the user account indicated in the prior field

  4. Click Save Changes

The Domain has been added and will be selectable in the Domain dropdown during provisioning, and in Cloud and Network settings.

Editing Domain Permissions

To edit visibility permissions for a domain, navigate to Infrastructure > Network > Domains. In the row for the selected domain, click MORE > Permissions. Within the Permissions modal, set Group and Tenant access permissions.

Note

Only resources assigned to the Master Tenant can be set as Publicly visible. If the Tenant assigned is not the master tenant, visibility will automatically change to private. Additionally, only Master Tenant users can set visibility for domains. Domains originating in a subtenant will always be private to that subtenant.

Group Access

Configure the domain to be visible to all Infrastructure Groups or only to selected Groups. If the domain is scoped to specific Groups, Users whose Roles do not give them Group access will not have access to the domain. Additionally, users will not be able to set the domain as the default on a Cloud which is not a part of the selected Groups.

Tenant Permissions

When set to public, all Tenants will have visibility into the domain and can join their Instances to the domain. When set to private, users can select specific Tenants which should have access to the domain.

Editing and Removing Domains

  • Domains can be edited by selecting the Actions dropdown for the Domain and selecting Edit.

  • Added Domains can be removed from Morpheus by selecting the Actions dropdown for the Domain and selecting Remove.

Setting the default domain on a Cloud

  1. Navigate to Infrastructure -> Clouds.

  2. Edit the target Cloud.

  3. Expand Advanced Options section.

  4. In the Domain dropdown, select the Domain.

  5. Save Changes

Setting the default domain on a Network

  1. Navigate to Infrastructure -> Network.

  2. Edit the target Network.

  3. Expand Advanced Options section.

  4. In the Domain dropdown, select the Domain.

  5. Save Changes

Selecting a Domain while provisioning an instance

  1. While creating an instance, in the Configure section, expand the DNS Options.

  2. Select Domain from the Domain dropdown.