Deploy Docker Registry

A simple self-hosted docker registry

Deploy Docker Registry

Docker Registry

registry:2

Just deployed

/var/lib/registry

Deploy and Host Docker Registry on Railway

Docker Registry is an open-source service from Docker that lets you host and manage your own container images privately. Instead of relying on Docker Hub or external registries, you can store, version, and distribute images directly from your own infrastructure.

About Hosting Docker Registry

Hosting a Docker Registry gives you full control over your image storage, access, and performance. It involves running a registry:2 container image, configuring filesystem or cloud-backed storage (like Railway volumes or S3), and exposing it securely via TCP or HTTPS. Using Railway, you can easily deploy the registry with persistent storage, define environment variables, and access it through a custom domain or TCP proxy for Docker CLI operations.

Common Use Cases

  • Hosting private container images for internal projects
  • Caching frequently used public images for faster CI/CD pipelines
  • Serving images for multi-environment deployments or air-gapped setups

Dependencies for Docker Registry Hosting

  • Docker (for building/pushing images)

Deployment Dependencies

Implementation Details

Dockerfile

FROM registry:2

ENV REGISTRY_HTTP_ADDR=:8080
ENV REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry

EXPOSE 8080

Railway Setup

  • Attach a volume mounted to /var/lib/registry
  • Set environment variables:
    REGISTRY_HTTP_ADDR=:8080
    REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY=/var/lib/registry
    
  • Add a TCP Proxy or Custom Domain for registry access
  • Deploy and run:
    docker login 
    docker push /<img>
    

Why Deploy Docker Registry on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Docker Registry on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


Template Content

Docker Registry

registry:2

More templates in this category

View Template
Postgres-to-R2 Backup
Auto back up PostgreSQL databases to Cloudflare R2 with optional encryption

View Template
ReadySet
A lightweight caching engine for Postgres

View Template
Simple S3
Deploy a S3-compatible storage service with a pre-named bucket.