Registree

A lightweight web UI for browsing and managing a self-hosted Docker Registry v2 and v3: repositories, tags, manifest details, and tag deletion.

Getting started

pnpm install
pnpm start

The app runs at http://localhost:4200.

Running with Docker

Build the image:

docker build -t registree .
docker run -p 8080:80 -e REGISTRY_URL=https://registry.example.com registree

Note: the registry must send CORS headers, e.g. via the Docker Registry http.headers config if the domain is different

http:
  headers:
    Access-Control-Allow-Origin: ["http://localhost:8080"]
    Access-Control-Allow-Methods: ["GET", "DELETE", "OPTIONS"]
    Access-Control-Allow-Headers: ["Authorization", "Accept"]
    Access-Control-Expose-Headers: ["Docker-Content-Digest", "Link"]

Serving under a sub-path

To serve the UI at a path other than / (e.g. registry.mysite.fr/ui), set REGISTRY_UI_URL to that path. This assumes your reverse proxy strips the prefix before forwarding to this container (so it still receives plain /, /repositories, etc.):

docker run -p 8080:80 \
  -e REGISTRY_URL=https://registry.example.com \
  -e REGISTRY_UI_URL=/ui \
  registree