Hide navigation sidebar
Hide table of contents sidebar
Back to top
Toggle table of contents sidebar

# Environment variables

The Incus 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
--- | ---
`INCUS_DIR` | The Incus data directory
`INCUS_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)
`INCUS_CONF` | Path to the client configuration directory
`INCUS_GLOBAL_CONF` | Path to the global client configuration directory
`INCUS_REMOTE` | Name of the remote to use (overrides configured default remote)
`INCUS_PROJECT` | Name of the project to use (overrides configured default project)

## Server environment variable

Name | Description
--- | ---
`INCUS_AGENT_PATH` | Path to the directory including the `incus-agent` builds
`INCUS_CLUSTER_UPDATE` | Script to call on a cluster update
`INCUS_DEVMONITOR_DIR` | Path to be monitored by the device monitor. This is primarily for testing
`INCUS_DOCUMENTATION` | Path to the documentation to serve through the web server
`INCUS_EXEC_PATH` | Full path to the Incus binary (used when forking subcommands)
`INCUS_IDMAPPED_MOUNTS_DISABLE` | Disable idmapped mounts support (useful when testing traditional UID shifting)
`INCUS_LXC_TEMPLATE_CONFIG` | Path to the LXC template configuration directory
`INCUS_OVMF_PATH` | Path to an OVMF build including `OVMF_CODE.fd` and `OVMF_VARS.ms.fd`
`INCUS_SECURITY_APPARMOR` | If set to `false`, forces AppArmor off
`INCUS_UI` | Path to the web UI to serve through the web server