https://github.com/httptoolkit/docker-registry-facade
A tiny self-hostable Docker Registry facade - own your image URL without running your own registry
https://github.com/httptoolkit/docker-registry-facade
Last synced: 28 days ago
JSON representation
A tiny self-hostable Docker Registry facade - own your image URL without running your own registry
- Host: GitHub
- URL: https://github.com/httptoolkit/docker-registry-facade
- Owner: httptoolkit
- License: apache-2.0
- Created: 2023-03-16T12:26:44.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-03-20T11:49:41.000Z (almost 2 years ago)
- Last Synced: 2025-01-21T01:11:15.768Z (about 1 month ago)
- Language: Dockerfile
- Homepage:
- Size: 29.3 KB
- Stars: 50
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Docker Registry Facade [](https://github.com/httptoolkit/docker-registry-facade/actions) [](https://hub.docker.com/r/httptoolkit/docker-registry-facade) [](https://ghcr.io/httptoolkit/docker-registry-facade)
> _Part of [HTTP Toolkit](https://httptoolkit.com): powerful tools for building, testing & debugging HTTP(S)_
A tiny self-hostable Docker Registry facade - own your registry URL without running your own registry (there's more details about how this works in [the blog post](https://httptoolkit.com/blog/docker-image-registry-facade/)).
This is intended to help organizations publishing images mitigate the upcoming Dockerpocalypse by:
* Allowing immediate migration to a self-controlled registry URL now, while still using Docker Hub as the backend temporarily.
* Ensuring that organizations control their own image URLs, so they can migrate registries in future without risking the same issues.
## How to run this
To test this out locally, try this:
```
docker run \
-e'REGISTRY_HOST=registry.hub.docker.com' \
-p443:443 \
ghcr.io/httptoolkit/docker-registry-facade
```
and then pull from it, e.g. with:
```
docker pull localhost/httptoolkit/docker-registry-facade
```
Remember that when specifying a registry explicitly like this, non-namespaced images that work automatically with Docker Hub, like `nginx` and `busybox`, need to be referenced fully in the `library` namespace, e.g. `docker pull localhost/library/busybox`.
To configure this further, you can set the following environment variables:
* `REGISTRY_HOST` (required): the hostname of the target registry, e.g. `registry.hub.docker.com`
* `REGISTRY_ORG`: the org on the target registry which should be supported. If specified, only images from this organization will be accessible. If not, this facade will be usable to pull all images from any organization.
* `ADDRESS`: the address that the container should listen on. This must be a [Caddyfile address](https://caddyserver.com/docs/caddyfile/concepts#addresses) (the default is `*`, which implies HTTPS on port 443).
* `CACHE_TIMEOUT`: the redirects that this image serves come with cache headers to try & limit unnecessary requests. The default timeout is 1 day, but you can reduce it by specifying a number of seconds here.