Adding an Insecure Registry to Podman Desktop
In this guide, you will learn how to add an insecure registry to Podman Desktop. An insecure registry allows you to pull and push container images either over an unencrypted HTTP connection, or a HTTPS connection with a self-signed unverified certificate. Please note that using an insecure registry can expose your data to security risks, so it's recommended to use secure connections with a verifiable certificate whenever possible.
Prerequisites
- Podman installed and running (VM if on macOS or Windows).
Procedure
- macOS & Windows
- Linux
Add your insecure registry within Settings > Registries.
Click "Yes" to the insecure registry warning.
- SSH into the Podman Machine to edit
registries.conf
.
$ podman machine ssh [optional-machine-name]
- Open
registries.conf
.
$ sudo vi /etc/containers/registries.conf
- Add the insecure registry: Add a new [[registry]] section for the URL of the insecure registry you want to use. For example, if your insecure registry is located at
http://registry.example.com
, add the following lines:
[[registry]]
location = registry.example.com
insecure = true
If you have multiple registries, you can add one [[registry]] block per registry.
Save and exit the file.
Restart Podman by the CLI or through Podman Desktop.
$ podman machine stop
$ podman machine start
- Pull or push container images: You can now use Podman Desktop to pull or push container images from/to the insecure registry you added.
Add your insecure registry within Settings > Registries.
Click "Yes" to the insecure registry warning.
- Open
registries.conf
.
$ sudo vi /etc/containers/registries.conf
- Add the insecure registry: Add a new [[registry]] section for the URL of the insecure registry you want to use. For example, if your insecure registry is located at
http://registry.example.com
, add the following lines:
[[registry]]
location = registry.example.com
insecure = true
If you have multiple registries, you can add one [[registry]] block per registry:
Save and exit the file.
Restart Podman.
$ sudo systemctl restart podman
- Pull or push container images: You can now use Podman Desktop to pull or push container images from/to the insecure registry you added.