<a id="server-configure"></a>

# How to configure the LXD server

See [Server configuration](https://canonical.com/lxd/docs/default/server/index.html.md#server) for all configuration options that are available for the LXD server.

If the LXD server is part of a cluster, some of the options apply to the cluster, while others apply only to the local server, thus the cluster member.
In the [Server configuration](https://canonical.com/lxd/docs/default/server/index.html.md#server) option tables, options that apply to the cluster are marked with a `global` scope, while options that apply to the local server are marked with a `local` scope.

## Configure server options

CLI

You can configure a server option with the following command:

```none
lxc config set <key> <value>
```

For example, to allow remote access to the LXD server on port 8443, enter the following command:

```none
lxc config set core.https_address :8443
```

In a cluster setup, to configure a server option for a cluster member only, add the `--target` flag.
For example, to configure where to store image tarballs on a specific cluster member, enter a command similar to the following:

```none
lxc config set storage.images_volume my-pool/my-volume --target member02
```

API

Send a PATCH request to the `/1.0` endpoint to update one or more server options:

```none
lxc query --request PATCH /1.0 --data '{
  "config": {
    "<key>": "<value>",
    "<key>": "<value>"
  }
}'
```

For example, to allow remote access to the LXD server on port 8443, send the following request:

```none
lxc query --request PATCH /1.0 --data '{
  "config": {
    "core.https_address": ":8443"
  }
}'
```

In a cluster setup, to configure a server option for a cluster member only, add the `target` parameter to the query.
For example, to configure where to store image tarballs on a specific cluster member, send a request similar to the following:

```none
lxc query --request PATCH /1.0?target=member02 --data '{
  "config": {
    "storage.images_volume": "my-pool/my-volume"
  }
}'
```

See [`PATCH /1.0`](/lxd/stable-5.21/api/#/server/server_patch) for more information.

UI

Go to Settings to configure the server options.

In a cluster setup, server options that apply to the local server are updated only for the server on which you are accessing the UI.
For example, if you access the UI on `server1` and update the location for storing image tarballs ([`storage.images_volume`](https://canonical.com/lxd/docs/default/server/index.html.md#server-miscellaneous:storage.images_volume), which has a `local` scope) from `local/pool1` to `local/pool2`, `storage.images_volume` will still be configured to `local/pool1` on `server2`.

## Display the server configuration

CLI

To display the current server configuration, enter the following command:

```none
lxc config show
```

In a cluster setup, to show the local configuration for a specific cluster member, add the `--target` flag.

API

Send a GET request to the `/1.0` endpoint to display the current server environment and configuration:

```none
lxc query --request GET /1.0
```

In a cluster setup, to show the local environment and configuration for a specific cluster member, add the `target` parameter to the query:

```none
lxc query --request GET /1.0?target=<cluster_member>
```

See [`GET /1.0`](/lxd/stable-5.21/api/#/server/server_get) for more information.

UI

Go to Settings to view the current server configuration.

In a cluster setup, this view shows the local configuration for the cluster member on which you are accessing the UI.

## Edit the full server configuration

CLI

To edit the full server configuration as a YAML file, enter the following command:

```none
lxc config edit
```

In a cluster setup, to edit the local configuration for a specific cluster member, add the `--target` flag.

API

To update the full server configuration, send a PUT request to the `/1.0` endpoint:

```none
lxc query --request PUT /1.0 --data '<server_configuration>'
```

In a cluster setup, to update the full server configuration for a specific cluster member, add the `target` parameter to the query:

```none
lxc query --request PUT /1.0?target=<cluster_member> '<server_configuration>'
```

See [`PUT /1.0`](/lxd/stable-5.21/api/#/server/server_put) for more information.

UI

The UI does not currently support editing the full server configuration.