Environment variables#

Introduction#

The LXD client and daemon respect some environment variables to adapt to the user’s environment and to turn some advanced features on and off.

Common#

Name

Description

LXD_DIR

The LXD data directory

LXD_INSECURE_TLS

If set to true, allows all default Go ciphers both for client <-> server communication and server <-> image servers (server <-> server and clustering are not affected)

PATH

List of paths to look into when resolving binaries

http_proxy

Proxy server URL for HTTP

https_proxy

Proxy server URL for HTTPS

no_proxy

List of domains, IP addresses or CIDR ranges that don’t require the use of a proxy

Client environment variable#

Name

Description

EDITOR

What text editor to use

VISUAL

What text editor to use (if EDITOR isn’t set)

LXD_CONF

Path to the LXC configuration directory

LXD_GLOBAL_CONF

Path to the global LXC configuration directory

LXC_REMOTE

Name of the remote to use (overrides configured default remote)

Server environment variable#

Name

Description

LXD_EXEC_PATH

Full path to the LXD binary (used when forking subcommands)

LXD_LXC_TEMPLATE_CONFIG

Path to the LXC template configuration directory

LXD_SECURITY_APPARMOR

If set to false, forces AppArmor off

LXD_UNPRIVILEGED_ONLY

If set to true, enforces that only unprivileged containers can be created. Note that any privileged containers that have been created before setting LXD_UNPRIVILEGED_ONLY will continue to be privileged. To use this option effectively it should be set when the LXD daemon is first setup.

LXD_OVMF_PATH

Path to an OVMF build including OVMF_CODE.fd and OVMF_VARS.ms.fd

LXD_SHIFTFS_DISABLE

Disable shiftfs support (useful when testing traditional UID shifting)

LXD_IDMAPPED_MOUNTS_DISABLE

Disable idmapped mounts support (useful when testing traditional UID shifting)

LXD_DEVMONITOR_DIR

Path to be monitored by the device monitor. This is primarily for testing.