<a id="ref-image-registries"></a>

# Image registries

Image registries can be configured through a set of key/value configuration options.
See [Configure an image registry](https://canonical.com/lxd/docs/latest/howto/image_registries/index.html.md#howto-image-registries-configure) for instructions on how to set these options.

The following options are available:

<!-- Include content from [../metadata.txt](../metadata.txt) -->

<a id="image-registry-image-registry-conf:cluster"></a>
`cluster`

Cluster link name for image registry using “LXD” protocol

[<i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i>](#image-registry-image-registry-conf:cluster)

| **Key:**      | `cluster`   |
|---------------|-------------|
| **Type:**     | string      |
| **Required:** | no          |

<a id="image-registry-image-registry-conf:source_project"></a>
`source_project`

Source project for image registry using “LXD” protocol

[<i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i>](#image-registry-image-registry-conf:source_project)

| **Key:**      | `source_project`   |
|---------------|--------------------|
| **Type:**     | string             |
| **Required:** | no                 |

<a id="image-registry-image-registry-conf:url"></a>
`url`

Source URL for image registry using “SimpleStreams” protocol

[<i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i>](#image-registry-image-registry-conf:url)

| **Key:**      | `url`   |
|---------------|---------|
| **Type:**     | string  |
| **Required:** | no      |

<a id="image-registry-image-registry-conf:user.*"></a>
`user.*`

User-provided free-form key/value pairs

[<i class="icon"><svg><use href="#svg-arrow-right"></use></svg></i>](#image-registry-image-registry-conf:user.*)

| **Key:**    | `user.*`   |
|-------------|------------|
| **Type:**   | string     |

## Related topics

How-to guides:

- [Images](https://canonical.com/lxd/docs/latest/images/index.html.md#images)

Explanation:

- [Local and remote images](https://canonical.com/lxd/docs/latest/image-handling/index.html.md#about-images)
