# Appliance Settings

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.

NOTE

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
:   A CORS-related field which specifies the origins that are allowed to access the VM Essentials API. For example, if you were designing a web application which needed to make AJAX calls to VM Essentials API. The origins should be specified here. By default, all origins are allowed. When this field is filled, an exclusive whitelist of allowed origins is established.

Cloud Sync Interval
:   Data is refreshed through cloud integrations at the interval specified here in seconds, the default value is 300 seconds (five minutes). Appliances managing a very large number of clouds may be adversely affected by setting this value too low.

Cluster Sync Interval
:   Data is refreshed through provisioned Clusters at the interval specified here in seconds, the default value is 60 seconds. Appliances managing a very large number of Clusters may be adversely affected by setting this value too low.

Usage Retainment
:   Determines how many days to keep account usage (metered costing data) records. Retainment period is not set by default. Usage records will remain indefinitely if Usage Retainment is not set. Note this does not affect generated Invoice records.

Invoice Retainment
:   Enter the number of days VM Essentials should keep invoice records in the database. In general, this setting can be left alone but in certain cases may need to be adjusted as very large invoice database tables can affect the stability of the application.

Incident Retainment
:   Enter the number of days VM Essentials should keep incident records in the database. In general, this setting can be left alone but in certain cases may need to be adjusted as very large incident database tables can affect the stability of the application.

Stats Retainment
:   Select 30, 60 or 90 days period for stats retainment. Selecting a larger period gives the ability to analyze stats, such as Instance metrics, over a longer period of time. For example, in the Monitoring tab of an Instance detail page, users can select a 60 or 90-day analysis period if the stats have been retained that long

Denied Hosts
:   A comma-delimited list of IP addresses and/or hostnames which should not be allowed sources for HTTP Tasks or REST-populated Option Lists.

Approved Hosts
:   A comma-delimited list of IP addresses and/or hostnames which are the only approved sources for HTTP Tasks or REST-populated Option Lists. By entering any values here, all others are automatically denied.

Exchange URL
:   Enter the URL which should be checked for updates to any installed plugins. The default exchange is: `https://share.morpheusdata.com`

Skip Agent Install
:   For appliances in which skipping the Agent install is the default selection, enable this global flag to default to skipping the Agent install during provisioning

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.

Default Appliance Locale
:   Sets the default language and region for all users on the VM Essentials appliance. Users with individual language preferences may also override this selection on their User Settings page

Default Console Gateway
:   Select a configured VM Essentials Worker as a console gateway or VDI gateway. For more on installation and configuration of a gateway, see the [VDI Gateways section](https://docs.morpheusdata.com/en/latest/tools/vdi_pools.html#vdi-gateways) of VM Essentials documentation.

Max Option List Size
:   Sets a maximum size for Option Lists (such as those sourced from REST calls to a remote server) to preserve appliance performance in the event that a very large payload is inadvertently accessed. The entered number is multiplied by 1000 (for example, entering “1” results in a maximum list size of 1000).
