Skip to main content

Forgejo Container Registry

⚡ Active by Default

The forgejo registry module connects to self-hosted or public Forgejo container registries.

Zero-Config for Public Images

Public packages work out of the box with zero configuration. Configure this module to monitor private repositories or avoid anonymous rate limits.

⚙️ Configuration Variables​

WUD_REGISTRY_FORGEJO_{registry_name}_LOGIN
Requiredstring

Forgejo username

Allowed values:Required when password/token is provided
WUD_REGISTRY_FORGEJO_{registry_name}_PASSWORD
Requiredstring

Forgejo password or Personal Access Token (PAT)

Allowed values:Required when username is provided
WUD_REGISTRY_FORGEJO_{registry_name}_URL
Requiredurl

Forgejo instance URL (e.g. https://forgejo.example.com)

Allowed values:Valid HTTP/HTTPS URL
WUD_REGISTRY_FORGEJO_{registry_name}_AUTH
Optionalstring

Direct Base64-encoded username:password string

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

🚀 Examples​

Authenticate with a Self-Hosted Forgejo Instance​

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_REGISTRY_FORGEJO_LOCAL_URL=https://forgejo.example.com
      - WUD_REGISTRY_FORGEJO_LOCAL_LOGIN=johndoe
      - WUD_REGISTRY_FORGEJO_LOCAL_PASSWORD=secret_pat_token