Skip to content

Commit b2e13c3

Browse files
committed
docs: add private registry documentation
Signed-off-by: Tomas Kral <tkral@redhat.com> Assisted-by: Claude Code
1 parent d5ac817 commit b2e13c3

1 file changed

Lines changed: 22 additions & 0 deletions

File tree

README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,28 @@ podman compose restart rhdh # or: docker compose restart rhdh
6868
podman compose down --volumes # or: docker compose down --volumes
6969
```
7070

71+
## Accessing Plugins from Private OCI Registries
72+
73+
If you need to install dynamic plugins from private OCI registries, you can mount your local container credentials into the `install-dynamic-plugins` service. This allows the plugin installer to authenticate with private registries using the credentials you already have configured on your system.
74+
75+
Add the following volume to the `install-dynamic-plugins` service in `compose.yaml`:
76+
77+
```yaml
78+
install-dynamic-plugins:
79+
volumes:
80+
# ... existing volumes ...
81+
- ~/.config/containers/auth.json:/opt/app-root/src/.config/containers/auth.json:Z
82+
```
83+
84+
This mounts your local `auth.json` file (which contains credentials for container registries like `registry.redhat.io`, `quay.io`, etc.) into the container. The credentials are typically created when you run `podman login` or `docker login`.
85+
86+
> **NOTE**: The location of `auth.json` may vary depending on your system configuration. Common locations include:
87+
>
88+
> - `~/.config/containers/auth.json` (Podman default)
89+
> - `~/.docker/config.json` (Docker default)
90+
>
91+
> Adjust the source path accordingly based on your container runtime.
92+
7193
## Additional Configuration Guides
7294

7395
If you would like to change your RHDH-Local setup, or add additional features or plugins, please check out the guides below.

0 commit comments

Comments
 (0)