# 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.