Custom / Self-Hosted Registry

🔐 Setup Required

The custom registry module allows connecting to any self-hosted, private, or third-party OCI-compliant registry.

---

⚙️ Configuration Variables

WUD_REGISTRY_CUSTOM_{registry_name}_URL

Requiredurl

Registry base URL (e.g. http://localhost:5000 or https://registry.local)

Allowed values:Valid HTTP/HTTPS URL

WUD_REGISTRY_CUSTOM_{registry_name}_AUTH

Optionalstring

Direct Base64-encoded username:password string

Allowed values:Base64-encoded username:password (mutually exclusive with LOGIN/PASSWORD)

WUD_REGISTRY_CUSTOM_{registry_name}_LOGIN

Optionalstring

Username (for Basic / htpasswd authentication)

Allowed values:Required when password is provided

WUD_REGISTRY_CUSTOM_{registry_name}_PASSWORD

Optionalstring

Password (for Basic / htpasswd authentication)

Allowed values:Required when username is provided

---

🚀 Examples

Anonymous Local Registry

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_REGISTRY_CUSTOM_LOCAL_URL=http://localhost:5000

Docker

docker run \
  -e WUD_REGISTRY_CUSTOM_LOCAL_URL="http://localhost:5000" \
  getwud/wud

Authenticated Private Registry

Docker Compose

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_REGISTRY_CUSTOM_LOCAL_URL=https://registry.example.com
      - WUD_REGISTRY_CUSTOM_LOCAL_LOGIN=admin
      - WUD_REGISTRY_CUSTOM_LOCAL_PASSWORD=secret_password

Docker

docker run \
  -e WUD_REGISTRY_CUSTOM_LOCAL_URL="https://registry.example.com" \
  -e WUD_REGISTRY_CUSTOM_LOCAL_LOGIN="admin" \
  -e WUD_REGISTRY_CUSTOM_LOCAL_PASSWORD="secret_password" \
  getwud/wud