# Docker Registry

Docker Registry is a self-hosted container image registry for storing and distributing Docker images over an HTTP API. It is open source and self-hosted, installable on Docker Hub, Unraid and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/6/docker-registry

## Description

Docker Registry is a self-hosted container image registry for storing and distributing Docker images over an HTTP API. It lets homelabbers run their own private registry to host custom images independently of Docker Hub. Based on the official Docker Registry image.

## Platform availability

Available on 2 of 6 install platforms: Unraid, Helm.

## Health score

55/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 13 days ago)
- Popular: 51 (357 GitHub stars)
- Easy to install: 20 (2 install platforms)

## Links

- Docker Hub: https://hub.docker.com/_/registry
- Unraid: https://ca.unraid.net/apps/dockerregistry-0yn3o290o3a7cd?q=DockerRegistry
- GitHub: https://github.com/docker/distribution-library-image
- Kubernetes (Helm): https://artifacthub.io/packages/helm/twuni/docker-registry

## Common questions

### How can I remove old tags or images from a private Docker registry?

You can query the registry to find tags or images and then delete the unwanted tags or images. The process can become more complicated when read-only mode and caches are involved.

### What should I configure to manage a Docker registry that keeps growing?

The relevant controls are retention and purging policies. You should review the registry interfaces and policies that determine which images are retained or removed.

### Can I expose Docker Registry under a non-root URL in a reverse proxy?

Workarounds are discussed for serving the registry from a URL that is not the root path.

### Which common configuration areas should I check when Docker Registry fails?

Check configuration mistakes, storage issues, and authentication problems. These are the common Docker Registry error categories covered in the practical operations guide.

## Alternatives

- Coolify: An open-source & self-hostable Heroku / Netlify / Vercel alternative.
- Heroku: Heroku is a platform as a service (PaaS) that enables developers to build, run, and operate applications entirely in the cloud.
- Railway: Provision infrastructure, develop locally, deploy to cloud, scale servers and storage, automate service discovery, and manage environments…
- Render: Render is a modern cloud provider that makes it effortless and instant to deploy your code in production.
- Sliplane: With Sliplane, shipping containers becomes incredibly easy and affordable.
- Vercel: Deploy to the most powerful serverless platform in the world with just one command.

---
Source: Our Local Host (https://ourlocalhost.com/app/6/docker-registry), the self-hosted and open-source app directory.