{"id":50689,"date":"2025-02-11T14:03:46","date_gmt":"2025-02-11T14:03:46","guid":{"rendered":"https:\/\/accuweb.cloud\/resource\/?post_type=faq&p=50689"},"modified":"2026-02-17T13:22:59","modified_gmt":"2026-02-17T13:22:59","slug":"set-up-private-docker-registry-on-ubuntu","status":"publish","type":"faq","link":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu","title":{"rendered":"How To Set Up a Private Docker Registry on Ubuntu?"},"content":{"rendered":"How To Set Up a Private Docker Registry on Ubuntu?<\/h2>\n

Introduction<\/h2>\n

Private Docker registries make it easy to share and distribute Docker images between containers. Setting up a private registry helps speed up deployments and ensures smooth CI\/CD workflows with Docker.<\/p>\n

In this guide, we\u2019ll learn how to set up and configure a private Docker registry that can be accessed externally.<\/p>\n

Requirements:<\/h2>\n

– A server or VPS running Ubuntu.<\/p>\n

– Root access to the server, or a user with sudo permissions to install packages and modify configurations.<\/p>\n

What is a Private Docker Registry?<\/h2>\n

A private Docker registry is a storage system<\/a> for Docker images hosted on a private server and accessible only to authorized users. It acts as a central repository for images, allowing authenticated Docker hosts to pull and push them.<\/p>\n

When configured on a server, the private registry interacts with Docker Hub over the internet to pull or push images. It then stores these images locally and shares them securely with other authorized Docker hosts. Docker hosts can connect to the private registry, pull the required images, and use them to build containers.<\/p>\n

Steps to Set Up a Private Docker Registry on Ubuntu<\/h2>\n

Follow these simple steps to set up a private Docker registry on an Ubuntu server.<\/p>\n

Install Docker on Ubuntu<\/h3>\n

Docker is a platform that lets you package and run applications<\/a> in lightweight, isolated containers. Containers are like virtual machines but more efficient and portable. Docker uses a client-server model, where the Docker daemon manages the containers.<\/p>\n

Before You Begin<\/b><\/p>\n

Remove old versions of Docker to avoid conflicts. This won’t delete your existing images, containers, or networks. Run:<\/p>\n

# apt-get remove docker docker-engine docker.io containerd runc<\/b><\/code><\/pre>\n
\"Remove<\/a><\/p>\n
If you get the error message “E: Unable to locate package docker-engine<\/b>“. It means that the Docker is not installed on your Ubuntu system.<\/p>\n
Install Docker from the Official Repository<\/h4>\n
To get the latest stable version of Docker, install it from the official Docker repository. Here\u2019s how:<\/p>\n
Step 1:<\/b>\u00a0Update the Package Repository<\/p>\n
Run the following command to update the system and install the necessary updates:<\/p>\n
# apt update<\/b><\/code><\/pre>\n
\"Update<\/a><\/p>\n
Step 2:\u00a0<\/b>Install Required Packages<\/p>\n
Install packages needed to securely download and manage Docker repositories:<\/p>\n
# apt install apt-transport-https ca-certificates curl software-properties-common -y<\/b><\/code><\/pre>\n
\"Install<\/a><\/p>\n
This command:<\/p>\n
– Enables apt to download packages over HTTPS.<\/p>\n
– Installs curl for data transfers.<\/p>\n
– Sets up tools for managing software.<\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n
Step 3:<\/b>\u00a0Add Docker’s GPG Key<\/p>\n
A GPG key ensures the software is authentic. Add Docker\u2019s GPG key by running:<\/p>\n
# curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | sudo apt-key add -<\/b><\/code><\/pre>\n
\"Add<\/a><\/p>\n
If successful, the output will display OK.<\/p>\n
Step 4:\u00a0<\/b>Add the Docker Repository<\/p>\n
Add Docker’s official repository to your system:<\/p>\n
# add-apt-repository \"deb [arch=amd64] https:\/\/download.docker.com\/linux\/ubuntu $(lsb_release -cs) stable\"<\/b><\/code><\/pre>\n
\"Add<\/a><\/p>\n
This updates the system to use the official Docker<\/a> repository for installation.<\/p>\n
Step 5:<\/b>\u00a0Verify the Installation Source<\/p>\n
To confirm Docker will be installed from the correct repository:<\/p>\n
# apt-cache policy docker-ce<\/b><\/code><\/pre>\n
\"Verify<\/a><\/p>\n
This checks that Docker will come from the official repository, not Ubuntu\u2019s default repository.<\/p>\n
Step 6:\u00a0<\/b>Install Docker<\/p>\n
Install Docker with the following command:<\/p>\n
# apt install docker-ce -y<\/b><\/code><\/pre>\n
\"Install<\/a><\/p>\n
Wait for the installation to complete.<\/p>\n
Step 7:\u00a0<\/b>Check Docker’s Status<\/p>\n
Verify that Docker is installed and running:<\/p>\n
# systemctl status docker<\/b><\/code><\/pre>\n
\"Check<\/a><\/p>\n
Suppose you are receiving an error message\u00a0Inactive (dead)<\/b>. It means that the service is in the stop status. You need to start it manually.<\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n
Step 8:<\/b>\u00a0Run the following command in the terminal to start the Docker service.<\/p>\n
# systemctl start docker<\/b><\/code><\/pre>\n
\"Start<\/a><\/p>\n
Step 9:<\/b>\u00a0To start the Docker service automatically on boot, run the following command in the terminal.<\/p>\n
# systemctl enable docker<\/b><\/code><\/pre>\n
\"Start<\/a><\/p>\n
The output will confirm that the Docker service is active and set to start automatically on boot.<\/p>\n
You\u2019re now ready to use Docker and proceed to set up your private Docker registry!<\/p>\n
Install Docker Compose on Ubuntu<\/h3>\n
Docker Compose is a tool that lets you manage multiple containers with a single command. It helps you define and run applications that rely on multiple services, such as caches, databases, or APIs.<\/p>\n
Note:<\/b> This guide explains how to install Docker<\/a> Compose V2, which uses the docker-compose command. The older docker-compose command (V1) is no longer supported.<\/div>\n
<\/div>\n
If you already have Docker installed on Linux, the recommended way to install Docker Compose is through the official Docker repository. Here\u2019s how to do it.<\/p>\n
Install Necessary Packages<\/h4>\n
Before adding the Docker repository, install some required packages:<\/p>\n
Step 1:<\/b>\u00a0Update the package list:<\/p>\n
# apt update<\/b><\/code><\/pre>\n
Step 2:<\/b>\u00a0Install certificate tools and curl:<\/p>\n
# apt install ca-certificates curl<\/b><\/code><\/pre>\n
\"Install<\/a><\/p>\n
Add Docker Repository<\/h4>\n
To get Docker Compose from the official Docker repository, follow these steps:<\/p>\n
Step 1:\u00a0<\/b>Create the \/etc\/apt\/keyrings directory and set proper permissions:<\/p>\n
# install -m 0755 -d \/etc\/apt\/keyrings<\/b><\/code><\/pre>\n
\"Set<\/a><\/p>\n
Step 2:\u00a0<\/b>Download the Docker GPG key:<\/p>\n
# curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg -o \/etc\/apt\/keyrings\/docker.asc<\/b><\/code><\/pre>\n
\"Download<\/a><\/p>\n
Step 3:<\/b>\u00a0Set read permissions for the key:<\/p>\n
# chmod a+r \/etc\/apt\/keyrings\/docker.asc<\/b><\/code><\/pre>\n
\"Set<\/a><\/p>\n
Step 4:<\/b>\u00a0Add the Docker repository to your system:<\/p>\n
# echo \"deb [arch=$(dpkg --print-architecture) signed-by=\/etc\/apt\/keyrings\/docker.asc] \\<\/b><\/code><\/pre>\n
https:\/\/download.docker.com\/linux\/ubuntu $(. \/etc\/os-release && echo \"$VERSION_CODENAME\") stable\" | \\<\/b><\/code><\/pre>\n
sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null<\/b><\/code><\/pre>\n
\"Add<\/a><\/p>\n
Install Docker Compose Plugin<\/h4>\n
Now that the Docker repository has been added, follow these steps to install Docker Compose:<\/p>\n
Step 1:\u00a0<\/b>Update the package list again:<\/p>\n
# apt update<\/b><\/code><\/pre>\n
Step 2:\u00a0<\/b>Install the Docker Compose plugin:<\/p>\n
# apt install docker-compose-plugin -y<\/b><\/code><\/pre>\n
\"Install<\/a><\/p>\n
If it is already installed, then you will get a message that docker-compose-plugin is already the newest version.<\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n
Step 3:<\/b>\u00a0Verify the installation:<\/p>\n
# docker compose version<\/b><\/code><\/pre>\n
\"Verify<\/a><\/p>\n
This will show the installed version of Docker Compose.<\/p>\n
Docker Compose is now installed and ready to use for managing multi-container applications.<\/p>\n
Install Nginx on Ubuntu<\/h4>\n
Nginx (pronounced \u201cEngine X\u201d) is an open-source web server. It works as a reverse proxy, directing client requests to the right server. Over time, it has added features like load balancing, scaling, and handling static files faster than Apache. These features improve performance<\/a> and resource usage.<\/p>\n
Steps to Install Nginx on Ubuntu<\/b><\/p>\n
Step 1:\u00a0<\/b>Log in to your server using SSH with the root user:<\/p>\n
Step 2:\u00a0<\/b>Before installing any software, update the package list to ensure you download the latest version. Run:<\/p>\n
# apt update<\/b><\/code><\/pre>\n
Let the update process finish.<\/p>\n
Step 3:\u00a0<\/b>Install Nginx by running:<\/p>\n
# apt install nginx<\/b><\/code><\/pre>\n
\"Install<\/a><\/p>\n
Wait for the system to download and install Nginx. Once done, you\u2019re ready to use it.<\/p>\n
Nginx is now installed and can be configured as needed!<\/p>\n
Install and Set Up a Private Docker Registry<\/h3>\n
To host a private Docker registry, you need to set up the registry service, configure an Nginx server, and create security certificates. Follow these steps to set up the private registry.<\/p>\n
Step 1:<\/b>\u00a0Create Registry Directories<\/p>\n
Start by organizing your files in a proper directory structure. Here\u2019s how:<\/p>\n
1. Create the main directory for the registry and subdirectories for Nginx and authentication:<\/p>\n
# mkdir -p registry\/{nginx,auth}<\/b><\/code><\/pre>\n
\"Create<\/a><\/p>\n
2. Inside the nginx folder, create additional directories for configuration and SSL certificates:<\/p>\n
# mkdir -p registry\/nginx\/{conf.d,ssl}<\/b><\/code><\/pre>\n
\"Create<\/a><\/p>\n
3. Navigate to the registry directory and check the folder structure:<\/p>\n
# cd registry && tree<\/b><\/code><\/pre>\n
\"Registry<\/a><\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n
Note:<\/b> If the tree command is not installed, you can receive an error message “-bash: tree: command not found”. You can install it with:<\/p>\n
# apt install tree<\/b><\/code><\/pre>\n
\"Tree<\/a><\/p>\n
The output will show the complete directory structure for your private Docker registry.<\/p>\n
Step 2:<\/b>\u00a0Create Docker Compose File and Define Services<\/p>\n
To set up a private Docker registry, you’ll need a compose.yaml file to define the required services and configurations. Follow these steps to create and configure the file:<\/p>\n
1. Create the compose.yaml file<\/p>\n
Use a text editor to create a new file in the registry directory. For example, use Nano:<\/p>\n
# nano compose.yaml<\/b><\/code><\/pre>\n
2. Add the Docker Compose Configuration<\/p>\n
Paste the following content into the file:<\/p>\n
version: '3'<\/b>\r\nservices:<\/b>\r\n\u00a0 registry:<\/b>\r\n\u00a0 \u00a0 image: registry:2<\/b>\r\n\u00a0 \u00a0 restart: always<\/b>\r\n\u00a0 \u00a0 ports:<\/b>\r\n\u00a0 \u00a0 \u00a0 - \"5000:5000\"<\/b>\r\n\u00a0 \u00a0 environment:<\/b>\r\n\u00a0 \u00a0 \u00a0 REGISTRY_AUTH: htpasswd<\/b>\r\n\u00a0 \u00a0 \u00a0 REGISTRY_AUTH_HTPASSWD_REALM: Registry-Realm<\/b>\r\n\u00a0 \u00a0 \u00a0 REGISTRY_AUTH_HTPASSWD_PATH: \/auth\/registry.passwd<\/b>\r\n\u00a0 \u00a0 \u00a0 REGISTRY_STORAGE_FILESYSTEM_ROOTDIRECTORY: \/data<\/b>\r\n\u00a0 \u00a0 volumes:<\/b>\r\n\u00a0 \u00a0 \u00a0 - registrydata:\/data<\/b>\r\n\u00a0 \u00a0 \u00a0 - .\/auth:\/auth<\/b>\r\n\u00a0 \u00a0 networks:<\/b>\r\n\u00a0 \u00a0 \u00a0 - mynet<\/b>\r\n\u00a0 nginx:<\/b>\r\n\u00a0 \u00a0 image: nginx:alpine<\/b>\r\n\u00a0 \u00a0 container_name: nginx<\/b>\r\n\u00a0 \u00a0 restart: unless-stopped<\/b>\r\n\u00a0 \u00a0 tty: true<\/b>\r\n\u00a0 \u00a0 ports:<\/b>\r\n\u00a0 \u00a0 \u00a0 - \"80:80\"<\/b>\r\n\u00a0 \u00a0 \u00a0 - \"443:443\"<\/b>\r\n\u00a0 \u00a0 volumes:<\/b>\r\n\u00a0 \u00a0 \u00a0 - .\/nginx\/conf.d\/:\/etc\/nginx\/conf.d\/<\/b>\r\n\u00a0 \u00a0 \u00a0 - .\/nginx\/ssl\/:\/etc\/nginx\/ssl\/<\/b>\r\n\u00a0 \u00a0 networks:<\/b>\r\n\u00a0 \u00a0 \u00a0 - mynet<\/b>\r\nnetworks:<\/b>\r\n\u00a0 mynet:<\/b>\r\n\u00a0 \u00a0 driver: bridge<\/b>\r\nvolumes:<\/b>\r\n\u00a0 registrydata:<\/b>\r\n\u00a0 \u00a0 driver: local<\/b><\/code><\/pre>\n
\"Add<\/a><\/p>\n
Explanation of the Configuration<\/b><\/p>\n
Registry Service<\/b><\/p>\n
–\u00a0Image:<\/b>\u00a0Uses the Docker Registry image (registry:2).<\/p>\n
–\u00a0Restart Policy:<\/b>\u00a0restart: always ensures the service restarts automatically after a system reboot.<\/p>\n
–\u00a0Ports:\u00a0<\/b>Maps port 5000 inside the container to port 5000 on the host.<\/p>\n
Environment Variables:<\/b><\/p>\n
– Enables authentication (REGISTRY_AUTH) using the registry.passwd file.<\/p>\n
Specifies the location for data storage.<\/p>\n
– Volumes:<\/p>\n
registrydata volume stores registry data.<\/p>\n
Local auth directory holds the authentication file.<\/p>\n
–\u00a0Networks:<\/b>\u00a0Runs on the mynet Docker network.<\/p>\n
Nginx Service<\/b><\/p>\n
–\u00a0Image:<\/b>\u00a0Uses the lightweight nginx:alpine image.<\/p>\n
–\u00a0Container Name:<\/b>\u00a0Named nginx for easy identification.<\/p>\n
Ports:<\/b><\/p>\n
Maps port 80 for HTTP.<\/p>\n
Maps port 443 for HTTPS.<\/p>\n
Volumes:<\/b><\/p>\n
– Local conf.d directory for Nginx configuration files.<\/p>\n
– Local ssl directory for SSL certificates.<\/p>\n
Networks:<\/b>\u00a0Runs on the same mynet network as the registry service.<\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n
Networks and Volumes<\/b><\/p>\n
–\u00a0Network:<\/b>\u00a0mynet uses the bridge driver for service communication.<\/p>\n
–\u00a0Volume:<\/b>\u00a0registrydata uses the local driver to store registry data.<\/p>\n
3. Save and Close the File<\/p>\n
After adding the configuration, save the file (e.g., press Ctrl+O and Enter in Nano) and close it (e.g., press Ctrl+X).<\/p>\n
Your Docker Compose file is now ready to set up the private registry and Nginx services.<\/p>\n
Step 3:<\/b>\u00a0Set Up Nginx Port Forwarding<\/p>\n
To configure Nginx for your Docker registry, you’ll need to set up a virtual host with specific server settings. Follow these steps:<\/p>\n
1. Create a Virtual Host File<\/p>\n
Create a new file called registry.conf in the nginx\/conf.d directory:<\/p>\n
# nano nginx\/conf.d\/registry.conf<\/b><\/code><\/pre>\n
2. Add the Configuration<\/p>\n
Paste the following configuration into the file, replacing [domain] with your registry’s domain name (e.g., example.com):<\/p>\n
upstream docker-registry {<\/b>\r\n\u00a0 \u00a0 server registry:5000;<\/b>\r\n}<\/b>\r\nserver {<\/b>\r\n\u00a0 \u00a0 listen 80;<\/b>\r\n\u00a0 \u00a0 server_name registry.[domain];<\/b>\r\n\u00a0 \u00a0 return 301 https:\/\/registry.[domain]$request_uri;<\/b>\r\n}<\/b>\r\nserver {<\/b>\r\n\u00a0 \u00a0 listen 443 ssl http2;<\/b>\r\n\u00a0 \u00a0 server_name registry.[domain];<\/b>\r\n\u00a0 \u00a0 ssl_certificate \/etc\/nginx\/ssl\/fullchain.pem;<\/b>\r\n\u00a0 \u00a0 ssl_certificate_key \/etc\/nginx\/ssl\/privkey.pem;<\/b>\r\n\u00a0 \u00a0 error_log\u00a0 \/var\/log\/nginx\/error.log;<\/b>\r\n\u00a0 \u00a0 access_log \/var\/log\/nginx\/access.log;<\/b>\r\n\u00a0 \u00a0 location \/ {<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 if ($http_user_agent ~ \"^(docker\\\/1\\.(3|4|5(?!\\.[0-9]-dev))|Go ).*$\" )\u00a0 {<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 return 404;<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 }<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 proxy_pass\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 http:\/\/docker-registry;<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 proxy_set_header\u00a0 Host\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 $http_host;<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 proxy_set_header\u00a0 X-Real-IP\u00a0 \u00a0 \u00a0 \u00a0 \u00a0$remote_addr;<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 proxy_set_header\u00a0 X-Forwarded-For\u00a0 \u00a0$proxy_add_x_forwarded_for;<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 proxy_set_header\u00a0 X-Forwarded-Proto $scheme;<\/b>\r\n\u00a0 \u00a0 \u00a0 \u00a0 proxy_read_timeout\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 900;<\/b>\r\n\u00a0 \u00a0 }<\/b>\r\n}<\/b><\/code><\/pre>\n
\"Add<\/a><\/p>\n
3. Save and Exit<\/p>\n
Save the file (e.g., press Ctrl+O and then Enter in Nano).<\/p>\n
Exit the editor (e.g., press Ctrl+X).<\/p>\n
Configuration Details:<\/b><\/p>\n
1. Nginx to Registry Connection:<\/p>\n
– Nginx connects to the Docker registry on port 5000 using the docker-registry upstream.<\/p>\n
2. HTTP to HTTPS Redirection:<\/p>\n
The first server block listens on port 80 and redirects all traffic to HTTPS.<\/p>\n
3. Secure Connection:<\/p>\n
– The second server block listens on port 443 and uses SSL certificates for secure communication.<\/p>\n
– Specifies certificate files: \/etc\/nginx\/ssl\/fullchain.pem and \/etc\/nginx\/ssl\/privkey.pem.<\/p>\n
4. User Agent Restriction:<\/p>\n
– Blocks requests from older Docker clients (versions 1.5 and below) due to known issues.<\/p>\n
5. Proxy Configuration:<\/p>\n
– Passes client requests to the registry service.<\/p>\n
– Adds headers like Host, X-Real-IP, and X-Forwarded-For for better request tracking.<\/p>\n
Once this configuration is saved, Nginx will handle secure traffic for your private Docker registry.<\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n
Step 4:\u00a0<\/b>Increase Nginx File Upload Size<\/p>\n
Nginx has a default file upload size limit of 1MB. Since Docker images are often larger, you\u2019ll need to increase this limit. Follow these steps to raise the upload size to 2GB:<\/p>\n
1. Create a New Configuration File<\/p>\n
Open a new Nginx configuration file:<\/p>\n
# nano nginx\/conf.d\/additional.conf<\/b><\/code><\/pre>\n
2. Set the Upload Limit<\/p>\n
Add the following line to the file:<\/p>\n
client_max_body_size 2G;<\/b><\/code><\/pre>\n
\"Set<\/a><\/p>\n
3. Save and Exit<\/p>\n
– Save the file (e.g., press Ctrl+O and then Enter in Nano).<\/p>\n
– Exit the editor (e.g., press Ctrl+X).<\/p>\n
This will allow Nginx to accept files up to 2GB in size.<\/p>\n
Step 5:\u00a0<\/b>Set Up Basic Authentication<\/p>\n
Follow these steps to set up basic authentication:<\/p>\n
1. Create the Authentication File<\/p>\n
Navigate to the auth directory:<\/p>\n
# cd auth<\/b><\/code><\/pre>\n
\"Create<\/a><\/p>\n
2. Create a new password file named registry.passwd for your user:<\/p>\n
# htpasswd -Bc registry.passwd [username]<\/b><\/code><\/pre>\n
\"Create<\/a><\/p>\n
3. Set a Password<\/p>\n
– Enter a strong password when prompted and confirm it by typing it again.<\/p>\n
– The system will confirm the operation was successful.<\/p>\n
Now, your basic authentication is configured for added security<\/a>.<\/p>\n
Step 6:<\/b>\u00a0Start Docker Registry<\/p>\n
Now that everything is set up, follow these steps to run the Docker Registry and Nginx containers:<\/p>\n
1. Start the Containers<\/p>\n
Run the following command to launch the containers in the background (detached mode):<\/p>\n
# docker compose up -d<\/b><\/code><\/pre>\n
\"Start<\/a><\/p>\n
2. Verify the Services<\/p>\n
Check if the registry and Nginx services are running by typing:<\/p>\n
# docker compose ps<\/b><\/code><\/pre>\n
The output will display the running services and their assigned ports.<\/p>\n
Push Docker Image to Private Registry<\/h3>\n
Follow these steps to upload a Docker image to your private registry:<\/p>\n
Step 1:<\/b>\u00a0Log in to the Registry<\/p>\n
Run the following command to log in to your private Docker registry:<\/p>\n
# docker login https:\/\/registry.[domain]\/v2\/<\/b><\/code><\/pre>\n
For example, if your registry is at accucloudsupport.com, use:<\/p>\n
# docker login https:\/\/registry.accucloudsupport.com\/v2\/<\/b><\/code><\/pre>\n
\"Log<\/a><\/p>\n
Step 2:<\/b>\u00a0Enter Credentials<\/p>\n
Provide the username and password you created earlier during setup.<\/p>\n
Step 3:\u00a0<\/b>Push the Image<\/p>\n
Use the following command to push an image to the private registry:<\/p>\n
# docker push registry.[domain]\/[new-image-name]<\/b><\/code><\/pre>\n
\"Push<\/a><\/p>\n
Pull Image from Docker Hub to Private Registry<\/h3>\n
Follow these steps to download an image from Docker Hub and store it in your private registry:<\/p>\n
Step 1:\u00a0<\/b>Pull the Image<\/p>\n
Use the docker pull command to download the image from Docker Hub:<\/p>\n
# docker pull [image]<\/b><\/code><\/pre>\n
\"Pull<\/a><\/p>\n
Step 2:<\/b>\u00a0Tag the Image<\/p>\n
Add a tag to the image to label it for your private registry:<\/p>\n
# docker image tag [image] registry.[domain]\/[new-image-name]<\/b><\/code><\/pre>\n
\"Tag<\/a><\/p>\n
Step 3:<\/b>\u00a0Verify the Image Locally<\/p>\n
Check if the image is stored locally by listing all images:<\/p>\n
# docker images<\/b><\/code><\/pre>\n
\"Verify<\/a><\/p>\n
Conclusion<\/h2>\n
By following this guide, you’ve set up a private Docker registry on Ubuntu, configured Nginx, and added basic authentication. Now you can use it to manage Docker images and build containers on remote Docker hosts.<\/p>\n
<\/div>\n\t\t
\n\t\t\t        
\n            \n                        
\n                    
\n        
\n                    \n        \t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t
<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t            <\/div>\n        <\/div>\n                    <\/div>\n        <\/section>\n        \t\t<\/div>\n\t\t\n
<\/div>\n","protected":false},"author":1,"featured_media":52879,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","class_list":["post-50689","faq","type-faq","status-publish","has-post-thumbnail","hentry","faq_topics-kb","faq_topics-product-documentation","faq_topics-set-up-private-docker-registry","faq_topics-ubuntu"],"yoast_head":"\nSet Up a Private Docker Registry on Ubuntu | Step-by-Step<\/title>\n<meta name=\"description\" content=\"Learn how to set up a secure private Docker registry on Ubuntu. Follow this simple guide for a seamless configuration.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How To Set Up a Private Docker Registry on Ubuntu?\" \/>\n<meta property=\"og:description\" content=\"Learn how to set up a secure private Docker registry on Ubuntu. Follow this simple guide for a seamless configuration.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\" \/>\n<meta property=\"og:site_name\" content=\"AccuWeb Cloud\" \/>\n<meta property=\"article:modified_time\" content=\"2026-02-17T13:22:59+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1280\" \/>\n\t<meta property=\"og:image:height\" content=\"720\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"16 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#article\",\"isPartOf\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\"},\"author\":{\"name\":\"Jilesh Patadiya\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/#\/schema\/person\/a7a4cbe8405202b537509c757b588c58\"},\"headline\":\"How To Set Up a Private Docker Registry on Ubuntu?\",\"datePublished\":\"2025-02-11T14:03:46+00:00\",\"dateModified\":\"2026-02-17T13:22:59+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\"},\"wordCount\":1989,\"publisher\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/#organization\"},\"image\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage\"},\"thumbnailUrl\":\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg\",\"inLanguage\":\"en-US\"},{\"@type\":[\"WebPage\",\"FAQPage\"],\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\",\"url\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\",\"name\":\"Set Up a Private Docker Registry on Ubuntu | Step-by-Step\",\"isPartOf\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage\"},\"image\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage\"},\"thumbnailUrl\":\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg\",\"datePublished\":\"2025-02-11T14:03:46+00:00\",\"dateModified\":\"2026-02-17T13:22:59+00:00\",\"description\":\"Learn how to set up a secure private Docker registry on Ubuntu. Follow this simple guide for a seamless configuration.\",\"breadcrumb\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage\",\"url\":\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg\",\"contentUrl\":\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg\",\"width\":1280,\"height\":720},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/accuweb.cloud\/resource\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How To Set Up a Private Docker Registry on Ubuntu?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/#website\",\"url\":\"https:\/\/accuweb.cloud\/resource\/\",\"name\":\"AccuWeb Cloud\",\"description\":\"Cutting Edge Cloud Computing\",\"publisher\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/accuweb.cloud\/resource\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/#organization\",\"name\":\"AccuWeb.Cloud\",\"url\":\"https:\/\/accuweb.cloud\/resource\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/04\/accuwebcloud_logo_black_tagline.jpg\",\"contentUrl\":\"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/04\/accuwebcloud_logo_black_tagline.jpg\",\"width\":156,\"height\":87,\"caption\":\"AccuWeb.Cloud\"},\"image\":{\"@id\":\"https:\/\/accuweb.cloud\/resource\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/#\/schema\/person\/a7a4cbe8405202b537509c757b588c58\",\"name\":\"Jilesh Patadiya\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/accuweb.cloud\/resource\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/2cea2bdb5bbabb771ee67e96acad7396f25cb1a0c360b9bc4a9ac40cea9cd8b2?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/2cea2bdb5bbabb771ee67e96acad7396f25cb1a0c360b9bc4a9ac40cea9cd8b2?s=96&d=mm&r=g\",\"caption\":\"Jilesh Patadiya\"},\"description\":\"Jilesh Patadiya, the visionary Co-Founder and Chief Technology Officer (CTO) behind AccuWeb.Cloud. Founder & CTO at AccuWebHosting.com. He shares his web hosting insights on the AccuWeb.Cloud blog. He mostly writes on the latest web hosting trends, WordPress, storage technologies, and Windows and Linux hosting platforms.\",\"sameAs\":[\"https:\/\/accuweb.cloud\/resource\",\"https:\/\/www.facebook.com\/accuwebhosting\",\"https:\/\/www.instagram.com\/accuwebhosting\/\",\"https:\/\/www.linkedin.com\/company\/accuwebhosting\/\",\"https:\/\/x.com\/accuwebhosting\",\"https:\/\/www.youtube.com\/c\/Accuwebhosting\"],\"url\":\"https:\/\/accuweb.cloud\/resource\/author\/accuwebadmin\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Set Up a Private Docker Registry on Ubuntu | Step-by-Step","description":"Learn how to set up a secure private Docker registry on Ubuntu. Follow this simple guide for a seamless configuration.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu","og_locale":"en_US","og_type":"article","og_title":"How To Set Up a Private Docker Registry on Ubuntu?","og_description":"Learn how to set up a secure private Docker registry on Ubuntu. Follow this simple guide for a seamless configuration.","og_url":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu","og_site_name":"AccuWeb Cloud","article_modified_time":"2026-02-17T13:22:59+00:00","og_image":[{"width":1280,"height":720,"url":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg","type":"image\/jpeg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"16 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#article","isPartOf":{"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu"},"author":{"name":"Jilesh Patadiya","@id":"https:\/\/accuweb.cloud\/resource\/#\/schema\/person\/a7a4cbe8405202b537509c757b588c58"},"headline":"How To Set Up a Private Docker Registry on Ubuntu?","datePublished":"2025-02-11T14:03:46+00:00","dateModified":"2026-02-17T13:22:59+00:00","mainEntityOfPage":{"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu"},"wordCount":1989,"publisher":{"@id":"https:\/\/accuweb.cloud\/resource\/#organization"},"image":{"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage"},"thumbnailUrl":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg","inLanguage":"en-US"},{"@type":["WebPage","FAQPage"],"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu","url":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu","name":"Set Up a Private Docker Registry on Ubuntu | Step-by-Step","isPartOf":{"@id":"https:\/\/accuweb.cloud\/resource\/#website"},"primaryImageOfPage":{"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage"},"image":{"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage"},"thumbnailUrl":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg","datePublished":"2025-02-11T14:03:46+00:00","dateModified":"2026-02-17T13:22:59+00:00","description":"Learn how to set up a secure private Docker registry on Ubuntu. Follow this simple guide for a seamless configuration.","breadcrumb":{"@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#primaryimage","url":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg","contentUrl":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/07\/NEW-OG-IMAGE-URL.jpg","width":1280,"height":720},{"@type":"BreadcrumbList","@id":"https:\/\/accuweb.cloud\/resource\/articles\/set-up-private-docker-registry-on-ubuntu#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/accuweb.cloud\/resource\/"},{"@type":"ListItem","position":2,"name":"How To Set Up a Private Docker Registry on Ubuntu?"}]},{"@type":"WebSite","@id":"https:\/\/accuweb.cloud\/resource\/#website","url":"https:\/\/accuweb.cloud\/resource\/","name":"AccuWeb Cloud","description":"Cutting Edge Cloud Computing","publisher":{"@id":"https:\/\/accuweb.cloud\/resource\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/accuweb.cloud\/resource\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/accuweb.cloud\/resource\/#organization","name":"AccuWeb.Cloud","url":"https:\/\/accuweb.cloud\/resource\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/accuweb.cloud\/resource\/#\/schema\/logo\/image\/","url":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/04\/accuwebcloud_logo_black_tagline.jpg","contentUrl":"https:\/\/accuweb.cloud\/resource\/wp-content\/uploads\/2024\/04\/accuwebcloud_logo_black_tagline.jpg","width":156,"height":87,"caption":"AccuWeb.Cloud"},"image":{"@id":"https:\/\/accuweb.cloud\/resource\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/accuweb.cloud\/resource\/#\/schema\/person\/a7a4cbe8405202b537509c757b588c58","name":"Jilesh Patadiya","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/accuweb.cloud\/resource\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/2cea2bdb5bbabb771ee67e96acad7396f25cb1a0c360b9bc4a9ac40cea9cd8b2?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/2cea2bdb5bbabb771ee67e96acad7396f25cb1a0c360b9bc4a9ac40cea9cd8b2?s=96&d=mm&r=g","caption":"Jilesh Patadiya"},"description":"Jilesh Patadiya, the visionary Co-Founder and Chief Technology Officer (CTO) behind AccuWeb.Cloud. Founder & CTO at AccuWebHosting.com. He shares his web hosting insights on the AccuWeb.Cloud blog. He mostly writes on the latest web hosting trends, WordPress, storage technologies, and Windows and Linux hosting platforms.","sameAs":["https:\/\/accuweb.cloud\/resource","https:\/\/www.facebook.com\/accuwebhosting","https:\/\/www.instagram.com\/accuwebhosting\/","https:\/\/www.linkedin.com\/company\/accuwebhosting\/","https:\/\/x.com\/accuwebhosting","https:\/\/www.youtube.com\/c\/Accuwebhosting"],"url":"https:\/\/accuweb.cloud\/resource\/author\/accuwebadmin"}]}},"_links":{"self":[{"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/faq\/50689","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/faq"}],"about":[{"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/types\/faq"}],"author":[{"embeddable":true,"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/comments?post=50689"}],"version-history":[{"count":13,"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/faq\/50689\/revisions"}],"predecessor-version":[{"id":52945,"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/faq\/50689\/revisions\/52945"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/media\/52879"}],"wp:attachment":[{"href":"https:\/\/accuweb.cloud\/resource\/wp-json\/wp\/v2\/media?parent=50689"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}