Appliance Settings

The Administration > Settings section sets global configuration parameters for the Appliance, Tenant Registration, Email, Proxy and sets which Cloud types are enabled.

Appliance Settings

Host Level Firewall Enabled

Enables or Disables the host level firewall. This must be Enabled to use Morpheus Security Groups.

Appliance URL

The default URL used for Agent install and Agent functionality. All Instances and Hosts must be able to resolve and reach this URL over 443 for successful agent install and communication.


Alternate Appliance URLs can be configured per Cloud in the Edit Cloud -> Advanced Options section.

Internal Appliance URL (PXE)

For PXE-Boot your appliance needs to be routable directly with minimal NAT masquerading. This allows one to override the default appliance url endpoint for use by the PXE Server. If this is unset, the default appliance url will be used instead.

API Allowed Origins

Specifies which origins are allowed to access the Morpheus API.

Cloud Sync Interval

Data from integrated clouds is synced to Morpheus at an interval equal to the number of seconds entered. The default value is 300 seconds (equal to five minutes). It’s important to note that changing this value can have adverse effects on performance, especially in environments with very large numbers of Clouds.

Enable SSL Verification of Agent (Communications)

Enabling SSL Verification of Agent Communications requires a valid Certificate be installed on the Appliance.

Disable SSH Password Authentication

Only allow ssh login using SSH keys. When true, SSH Password Authentication will not be enabled for VM’s and Hosts provisioned after the setting is enabled.

Tenant Management Settings

Registration Enabled

If enabled, the appliance login screen will have a “NEED AN ACCOUNT? SIGN UP HERE” link added, enabling new Tenant registration.

Default Tenant Role

Sets the default Tenant Role applied to Tenants created from Tenant Registration.

Default User Role

Sets the default User Role applied to the User created from a Tenant Registration.

User Management Settings

Session Expires (Minutes)

User sessions are automatically closed when inactive for the number of minutes entered.

Session Warning (Minutes)

A pop-up warning is shown to the user when they have been inactive for the number of minutes entered. Example: If sessions are set to expire after 90 minutes, warn the user after 60 minutes if you intend to provide 30 minutes advance warning.

Expire Password After (Days)

User account passwords will expire after the entered number of days. Enter 0 or leave the field empty to opt out of this feature.

Disable User After Attempts (Number of Attempts)

Disable a User account after a specified number of failed login attempts. Enter 0 or leave the field empty to opt out of this feature.

Disable User If Inactive For (Days)

Disable a User account if inactive for the entered number of days. The User will not be able to log into the appliance again until another User with sufficient rights enables the account. Enter 0 or leave the field empty to opt out of this feature.

Send warning email before deactivating (Days)

Enter the number of days prior to account deactivation that a warning email should be sent. For example, enter “5” to warn the User when they are five days short of the deactivation time entered in the prior field. Enter 0 or leave the field empty to opt out of this feature.

Email Settings

A default installation of Morpheus uses a online service called postmarkapp. Morpheus api requests to the postmarkapp service to send notification e-mails.

To add your own SMTP server you will need to go to the Administration and Settings of your Morpheus appliance. You will then need to provide Morpheus the following information, your mail server systems administrator should provide you with the below information and the preferred encryption method.

  • From Address

  • SMTP Server

  • SMTP Port

  • SSL Enabled

  • TLS Encryption

  • SMTP User

  • SMTP Password

We recommend that you add your Morpheus server to your SMTP white list as well as using user authentication as an additional security measure.

Once you have added your SMTP server information into Morpheus scroll down the Administration and Settings page and press the blue save button which can be found under enabled clouds.

When you have saved your SMTP server settings in the Morpheus appliance you will then need to restart the Morpheus-ui. To restart the Morpheus-ui connection to your Morpheus server via ssh and run the below command.

sudo morpheus-ctl restart morpheus-ui


If you do not restart the Morpheus-ui the notifications will be sent by the original notification service postmarkapp. Please note it can take up to 3 minutes for the ui to become reachable again. has a built in SMTP server for email notifications and alerts. An alternate SMTP server can be specified below:

Add an alternate SMTP Server:

  • From Address

  • SMTP Server

  • SMTP Port

  • SSL Enabled

  • TLS Encryption

  • SMTP User

  • SMTP Password

Proxy Settings

The Morpheus Appliance can be configured to communicate through a Proxy server for Cloud API’s and Agent communication back to the Appliance.


Additional Proxy configuration is available in the Infrastructure -> Network -> Proxies section. Added Proxies can be scoped to Clouds in the Edit Cloud -> Advanced Options section of the Cloud.

Add a Global Proxy server by entering the following:

  • Proxy Host

  • Proxy Port

  • Proxy User

  • Proxy Password

  • Proxy Domain

  • Proxy Workstation

Enabled Clouds (Types)

Controls which types of Cloud can be created.

  • When a Cloud type is disabled, it will be removed from the available options when adding new Clouds in Infrastructure. Existing Clouds will not be affected.

Whitelabel Settings


Morpheus Tenants can be WhiteLabeled with custom Logos, Colors, Copy, and custom CSS. Sub-Tenants can be individually white-labeled, or the Master Tenant Whitelabel can apply to all Sub-Tenants.

Enable Whitelabel

Turns on the configured Whitelabel settings. Disabling will return the Appliance to the default colors and logos, but the configured options will remain saved and will apply if Whitelabel is re-enabled.

Appliance Name

Replaces Morpheus in page titles.

Header Logo

Top left header logo. Uploaded image is resized to 38 pixels high with a proportional width at that height.

Disable Support Menu

Enable this flag to hide the support dropdown menu in the header.

Support Menu Links

Customize support links. Label Code can be used for translations and is optional. Be sure to specify fully qualified url if linking to external sites.

Security Banner
The Security Banner section in /admin/settings#!whitelabel displays content on the login screen for Security and Consent messaging and warnings.
  • Applicable at Global and Tenant levels

  • Security Banner input field accepts plain text and markdown

  • Content is displayed below login section in scoped /login/auth pages.

Footer Logo

Footer Logo in bottom left. Uploaded image is resized to 27 pixels high with a proportional width at that height.

Login Logo

Logo shown on Login screen. Uploaded image is resized to 192 pixels wide with an unbound height proportional to that locked width.


Must be a .ico file type.


When selected and Whitelabel settings are saved, associated logo is returned to blank default value.


Update Colors by entering HEX value or selecting the Color Selector pop-up next to each filed and selecting a color.

  • Header Background

  • Header Foreground

  • Nav Background

  • Nav Foreground

  • Nav Hover

  • Primary Button Bg

  • Primary Button Fg

  • Primary Button Hover Bg

  • Primary Button Hover Fg

  • Footer Background

  • Footer Foreground

  • Login Background

Override CSS

Override CSS settings by entering CSS in Override CSS field.

Example: (this will add one continues background image to the Header)

header #topHeader {
        background-image: url(http://image_url.png);
header {
        background-image: url(http://image_url.png);


Add custom Copyright String, Terms of Use, Privacy Policy contained in the Footer text and links in the App and on the login page and emails.

Available Copy fields

  • Copyright String

  • Terms of Use

  • Privacy Policy


Terms of Use and Privacy Policy Footer links will load internal pages at https://applaince_url/privacy-policy and https://applaince_url/terms-of-use displaying the entered info as plain text.

​ UI Loading Page ^^^^^^^^^^^^^^^

When the Morpheus UI is restarted or loading, a default “Morpheus is Loading” page is displayed. This page can be changed by adding the following to /etc/morpheus/morpheus.rb and adjusting the values.


morpheus-ctl reconfigure must be ran for any chnages to /etc/morpheus/morpheus.rb to take effect.

nginx['web_root_internal'] = “/opt/morpheus/embedded/nginx/html"
nginx['loading_pages']['max_loops'] = 6 * 10 # 10 secs per loop x 6 times to get 60 seconds * 10 to get to 10 minutes
nginx['loading_pages']['timeout_page'] = '/timeout.html'
nginx['loading_pages']['iteration_time'] = 10_000
nginx['loading_pages']['loading_page_title'] = 'Morpheus Loading'
nginx['loading_pages']['loading_page_h1'] = 'Morpheus is Loading...'
nginx['loading_pages']['loading_page_h2'] = 'please wait'
nginx['loading_pages']['timout_page_title'] = 'Morpheus timeout, please try again...'
nginx['loading_pages']['timout_page_h1'] = 'Timeout waiting for Morpheus to load, click below to try again.'
nginx['loading_pages']['failure_page_title'] = 'Morpheus Server Error'
nginx['loading_pages']['failure_page_h1'] = 'Morpheus Server Error'
nginx['loading_pages']['failure_page_h2'] = 'Please contact your system administrator for assistance.'



Morpheus requires a valid license for provisioning new Instances, Apps and Hosts, and converting existing Instances and Hosts to managed. Licenses can be applied and updated in this section, and the current license status can be checked.

Current License

If a License Key has already been applied, the License status is shown in the Current License section:

Tenant Name

Company name the License was generated for.

Start Date

Date and time the current License started.

End Date

Date and time the current License expires.


Amount of used and unused Managed RAM under the current License.

EXAMPLE: On a 1 TB License with 182 GB of RAM under management, the Space section will show Used Space 182.9GB Unused Space 841.0GB


Once a current License expires or has reached its Space limit, users will no longer be able to provision new Instances, Apps, Hosts, or Bare Metal, or convert existing Hosts, Virtual Machines, or Bare Metal to managed. Morpheus will otherwise continue to function.

Upgrade License Key

To add a new or update an existing License:

  1. Copy the License Key into the License Key field

  2. Click UPDATE

If valid, the new License will be applied.

Request new License

Licenses can be requested at, or by contacting support@ or sales@

Utilities Settings

System administrators have access to a utilities panel with the following options:

  • Reindex all searchable data: Execute

  • Toggle Maintenance Mode: Enable

..NOTE:: Maintenance mode cleanly places Morpheus into a state where maintenance can be performed on the appliance. This drains any active sessions and queues so an auto-scaling group can scale down. It also drains active sessions across services.