Server configuration

The server configuration is a simple set of key and values.

The key/value configuration is namespaced with the following namespaces currently supported:

  • core (core daemon configuration)
  • images (image configuration)
  • maas (MAAS integration)
Key Type Default API extension Description
backups.compression_algorithm string gzip backup_compression Compression algorithm to use for new images (bzip2, gzip, lzma, xz or none)
candid.api.key string - candid_config_key Public key of the candid server (required for HTTP-only servers)
candid.api.url string - candid_authentication URL of the the external authentication endpoint using Candid
candid.expiry integer 3600 candid_config Candid macaroon expiry in seconds
candid.domains string - candid_config Comma-separated list of allowed Candid domains (empty string means all domains are valid)
cluster.https_address string - clustering_server_address Address the server should using for clustering traffic
cluster.offline_threshold integer 20 clustering Number of seconds after which an unresponsive node is considered offline
cluster.images_minimal_replica integer 3 clustering_image_replication Minimal numbers of cluster members with a copy of a particular image (set 1 for no replication, -1 for all members)
core.debug_address string - pprof_http Address to bind the pprof debug server to (HTTP)
core.https_address string - - Address to bind for the remote API (HTTPs)
core.https_allowed_credentials boolean - - Whether to set Access-Control-Allow-Credentials http header value to "true"
core.https_allowed_headers string - - Access-Control-Allow-Headers http header value
core.https_allowed_methods string - - Access-Control-Allow-Methods http header value
core.https_allowed_origin string - - Access-Control-Allow-Origin http header value
core.proxy_https string - - https proxy to use, if any (falls back to HTTPS_PROXY environment variable)
core.proxy_http string - - http proxy to use, if any (falls back to HTTP_PROXY environment variable)
core.proxy_ignore_hosts string - - hosts which don't need the proxy for use (similar format to NO_PROXY, e.g. 1.2.3.4,1.2.3.5, falls back to NO_PROXY environment variable)
core.trust_password string - - Password to be provided by clients to setup a trust
images.auto_update_cached boolean true - Whether to automatically update any image that LXD caches
images.auto_update_interval integer 6 - Interval in hours at which to look for update to cached images (0 disables it)
images.compression_algorithm string gzip - Compression algorithm to use for new images (bzip2, gzip, lzma, xz or none)
images.remote_cache_expiry integer 10 - Number of days after which an unused cached remote image will be flushed
maas.api.key string - maas_network API key to manage MAAS
maas.api.url string - maas_network URL of the MAAS server
maas.machine string hostname maas_network Name of this LXD host in MAAS

Those keys can be set using the lxc tool with:

lxc config set <key> <value>