Remotes¶
Introduction¶
Remotes are a concept in the LXD command line client which are used to refer to various LXD servers or clusters. A remote is effectively a name pointing to the URL of a particular LXD server as well as needed credentials to login and authenticate the server. LXD has four types of remotes:
Static
Default
Global (per-system)
Local (per-user)
Static¶
Static remotes are: - local (default) - ubuntu - ubuntu-daily
They are hardcoded and can’t be modified by the user.
Default¶
Automatically added on first use.
Global (per-system)¶
By default the global configuration file is kept in
/etc/lxc/config.yml
or in LXD_GLOBAL_CONF
if defined. The
configuration file can be manually edited to add global remotes.
Certificates for those remotes should be stored inside the
servercerts
directory (e.g. /etc/lxc/servercerts/) and match the
remote name (e.g. foo.crt
).
An example config is below:
remotes:
foo:
addr: https://10.0.2.4:8443
auth_type: tls
project: default
protocol: lxd
public: false
bar:
addr: https://10.0.2.5:8443
auth_type: tls
project: default
protocol: lxd
public: false
Local (per-user)¶
Local level remotes are managed from the CLI (lxc
) with:
lxc remote [command]
By default the configuration file is kept in
~/.config/lxc/config.yml
or in LXD_CONF
if defined. Users have
the possibility to override system remotes (e.g. by running
lxc remote rename
or lxc remote set-url
) which results in the
remote being copied to their own config, including any associated
certificates.