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.offline_threshold	integer	20	clustering	Number of seconds after which an unresponsive node is considered offline
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>