Docker Registry

Private container image registry powered by Docker Registry v3.

API: docker.registry.hochguertel.work Web UI: docker-ui.registry.hochguertel.work

Architecture

graph LR
    client["podman / docker"]
    token["Token Server\n(Python)"]
    registry["Registry v3\n(API)"]
    ui["Joxit UI"]
    authelia["Authelia\n(users DB)"]
    traefik["Traefik"]

    client --> traefik
    traefik --> token
    traefik --> registry
    traefik -->|"forward-auth"| ui
    token -->|"validate"| authelia
    token -->|"JWT"| registry

Features

• OCI-compliant container image storage
• Token-based authentication (validates against Authelia users)
• Web UI for browsing images and tags (Joxit)
• Image deletion support
• CORS configured for UI access

Quick Start

# Login
podman login docker.registry.hochguertel.work

# Push
podman tag myapp:latest docker.registry.hochguertel.work/myapp:v1.0
podman push docker.registry.hochguertel.work/myapp:v1.0

# Pull
podman pull docker.registry.hochguertel.work/myapp:v1.0

Configuration

Setting	Value
Registry URL	https://docker.registry.hochguertel.work
Web UI	https://docker-ui.registry.hochguertel.work
Auth	Custom token server → Authelia users DB
Storage	data/docker/registry/
Config	docker/config/registry.yml

Related Guides

• Developer Guide — pushing, pulling, CI/CD
• DevOps Guide — token server, certificates, backup