{"id":19337,"date":"2025-10-21T10:36:37","date_gmt":"2025-10-21T07:36:37","guid":{"rendered":"https:\/\/unihost.com\/help\/?p=19337"},"modified":"2025-10-21T10:36:37","modified_gmt":"2025-10-21T07:36:37","slug":"docker-registry","status":"publish","type":"post","link":"https:\/\/unihost.com\/help\/docker-registry\/","title":{"rendered":"Docker Registry"},"content":{"rendered":"

Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.<\/span><\/span><\/p>\n

1. Starting a local Docker Registry<\/b><\/span><\/p>\n

Docker provides an official registry image for creating a local registry.<\/span><\/p>\n

docker<\/span> run -d -p 5000:5000 --name registry registry:2<\/span><\/span><\/pre>\n
    \n
  • -d \u2014 runs the container in detached mode (in the background).<\/span><\/li>\n
  • -p 5000:5000 \u2014 maps port 5000 (the default port for the registry).<\/span><\/li>\n
  • –name registry \u2014 sets the container name.<\/span><\/li>\n
  • registry:2 \u2014 the official Docker Registry image.<\/span><\/li>\n<\/ul>\n
    Now the local registry is available at localhost:5000<\/strong>.<\/span><\/p>\n
    2. Configuring storage<\/b><\/span><\/h3>\n
    By default, images are stored in the container\u2019s memory. To enable persistent storage, add a volume:<\/span><\/p>\n
    docker<\/span> run -d -p 5000:5000 --name registry -v registry-data:\/var\/lib\/registry registry:2<\/span><\/span><\/pre>\n
    -v registry-data:\/var\/lib\/registry \u2014 Mounts the registry-data<\/strong> volume to store images.<\/span><\/p>\n
    3. Working with the local registry<\/b><\/span><\/h3>\n
    Tagging an image:<\/strong><\/span><\/p>\n
      \n
    1. To push an image to the local registry, you need to tag it with the prefix localhost:5000\/<\/strong>.<\/span><\/span>\n
      docker<\/span> tag my-image:latest localhost:5000\/my-image:latest<\/span><\/span><\/pre>\n<\/li>\n
    2. Pushing an image to the registry:<\/strong><\/span>\n
      docker<\/span> push localhost:5000\/my-image:latest<\/span>
      <\/span><\/span><\/pre>\n<\/li>\n
    3. \n
      Pulling an image from the registry:<\/strong><\/span><\/p>\n
      docker<\/span> pull localhost:5000\/my-image:latest<\/span><\/span><\/pre>\n<\/li>\n<\/ol>\n
      4. Configuring Docker to work with a local registry<\/b><\/span><\/h3>\n
      If you\u2019re using HTTPS or working on a remote machine, make sure Docker is configured to work with insecure registries<\/strong>. Add the following to the <\/span>\/etc\/docker\/daemon.json file:<\/span><\/span><\/p>\n
      {<\/span>

      \u00a0\u00a0\"insecure-registries\"<\/span>: [<\/span>\"localhost:5000\"<\/span>]<\/span><\/span>

      }<\/span><\/pre>\n
      Restart Docker:<\/span><\/p>\n
      sudo<\/span> systemctl restart docker<\/span><\/span><\/pre>\n
      5. <\/b>Additional settings (optional)<\/strong><\/span><\/h3>\n
      Authentication:<\/strong> To secure the registry, set up HTTP authentication using htpasswd:<\/span><\/p>\n
      docker<\/span> run -d -p 5000:5000 --name registry<\/span> \\<\/span><\/span>
      \u00a0\u00a0-v<\/span> $(<\/span>pwd<\/span>)<\/span>\/auth:\/auth<\/span> \\<\/span><\/span>
      \u00a0\u00a0-e \"REGISTRY_AUTH=htpasswd\"<\/span> \\<\/span><\/span>
      \u00a0\u00a0-e \"REGISTRY_AUTH_HTPASSWD_PATH=\/auth\/htpasswd\"<\/span> \\<\/span><\/span>
      \u00a0\u00a0-e \"REGISTRY_AUTH_HTPASSWD_REALM=Registry Realm\"<\/span> registry:2<\/span><\/span><\/pre>\n
      Create an htpasswd<\/strong> file using the following command:<\/span><\/p>\n
      htpasswd<\/span> -Bc auth\/htpasswd<\/span> <<\/span>usernam<\/span>e<\/span>><\/span><\/span><\/pre>\n
      TLS:<\/strong> For a production environment, configure TLS certificates to ensure a secure connection.<\/span><\/p>\n
      6. Checking the contents of the registry<\/b><\/span><\/h3>\n
      To view the available images, use the registry API:<\/span><\/p>\n
      curl<\/span> http:\/\/localhost:5000\/v2\/_catalog<\/span><\/span><\/pre>\n
      Conclusion<\/strong><\/span><\/p>\n
      Dependence on cloud registries and public Docker images can become a weak point for your service. However, proper strategies \u2014 such as using a local registry, caching, custom images, and redundancy \u2014 help minimize risks. Setting up a local mirror and using private registries give you control over your infrastructure, while monitoring and automation ensure stability. These measures help prevent service interruptions even in case of issues with external resources.<\/span><\/p>\n\n\n
      <\/p>\n","protected":false},"excerpt":{"rendered":"
      Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry. 1. Starting a local Docker […]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[158],"tags":[1065],"class_list":["post-19337","post","type-post","status-publish","format-standard","hentry","category-dedicated-servers","tag-docker-registry"],"yoast_head":"\nDocker Registry - Unihost.FAQ<\/title>\n<meta name=\"description\" content=\"Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/unihost.com\/help\/docker-registry\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Docker Registry - Unihost.FAQ\" \/>\n<meta property=\"og:description\" content=\"Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/unihost.com\/help\/docker-registry\/\" \/>\n<meta property=\"og:site_name\" content=\"Unihost.FAQ\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/unihost\/\" \/>\n<meta property=\"article:published_time\" content=\"2025-10-21T07:36:37+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/unihost.com\/help\/minio.php?.\/unihost-logo-alt.png\" \/>\n\t<meta property=\"og:image:width\" content=\"250\" \/>\n\t<meta property=\"og:image:height\" content=\"141\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Unihost Support\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@unihost\" \/>\n<meta name=\"twitter:site\" content=\"@unihost\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Unihost Support\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/unihost.com\/help\/docker-registry\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/unihost.com\/help\/docker-registry\/\"},\"author\":{\"name\":\"Unihost Support\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a\"},\"headline\":\"Docker Registry\",\"datePublished\":\"2025-10-21T07:36:37+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/unihost.com\/help\/docker-registry\/\"},\"wordCount\":335,\"publisher\":{\"@id\":\"https:\/\/unihost.com\/help\/#organization\"},\"keywords\":[\"Docker Registry\"],\"articleSection\":[\"02. Dedicated servers\"],\"inLanguage\":\"en\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/unihost.com\/help\/docker-registry\/\",\"url\":\"https:\/\/unihost.com\/help\/docker-registry\/\",\"name\":\"Docker Registry - Unihost.FAQ\",\"isPartOf\":{\"@id\":\"https:\/\/unihost.com\/help\/#website\"},\"datePublished\":\"2025-10-21T07:36:37+00:00\",\"description\":\"Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.\",\"breadcrumb\":{\"@id\":\"https:\/\/unihost.com\/help\/docker-registry\/#breadcrumb\"},\"inLanguage\":\"en\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/unihost.com\/help\/docker-registry\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/unihost.com\/help\/docker-registry\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Unihost\",\"item\":\"https:\/\/unihost.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Help\",\"item\":\"https:\/\/unihost.com\/help\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Docker Registry\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/unihost.com\/help\/#website\",\"url\":\"https:\/\/unihost.com\/help\/\",\"name\":\"Unihost.FAQ\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/unihost.com\/help\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/unihost.com\/help\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/unihost.com\/help\/#organization\",\"name\":\"Unihost\",\"alternateName\":\"Unihost\",\"url\":\"https:\/\/unihost.com\/help\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png\",\"contentUrl\":\"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png\",\"width\":300,\"height\":300,\"caption\":\"Unihost\"},\"image\":{\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/unihost\/\",\"https:\/\/x.com\/unihost\",\"https:\/\/www.instagram.com\/unihost\/?hl=en\",\"https:\/\/www.linkedin.com\/company\/unihost-com\",\"https:\/\/www.youtube.com\/channel\/UCITKsxMDnslQY8brN3advgw\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a\",\"name\":\"Unihost Support\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en\",\"@id\":\"https:\/\/unihost.com\/help\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g\",\"caption\":\"Unihost Support\"},\"sameAs\":[\"https:\/\/unihost.com\/\"],\"url\":\"https:\/\/unihost.com\/help\/author\/support\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Docker Registry - Unihost.FAQ","description":"Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.","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:\/\/unihost.com\/help\/docker-registry\/","og_locale":"en_US","og_type":"article","og_title":"Docker Registry - Unihost.FAQ","og_description":"Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.","og_url":"https:\/\/unihost.com\/help\/docker-registry\/","og_site_name":"Unihost.FAQ","article_publisher":"https:\/\/www.facebook.com\/unihost\/","article_published_time":"2025-10-21T07:36:37+00:00","og_image":[{"width":250,"height":141,"url":"https:\/\/unihost.com\/help\/minio.php?.\/unihost-logo-alt.png","type":"image\/png"}],"author":"Unihost Support","twitter_card":"summary_large_image","twitter_creator":"@unihost","twitter_site":"@unihost","twitter_misc":{"Written by":"Unihost Support","Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/unihost.com\/help\/docker-registry\/#article","isPartOf":{"@id":"https:\/\/unihost.com\/help\/docker-registry\/"},"author":{"name":"Unihost Support","@id":"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a"},"headline":"Docker Registry","datePublished":"2025-10-21T07:36:37+00:00","mainEntityOfPage":{"@id":"https:\/\/unihost.com\/help\/docker-registry\/"},"wordCount":335,"publisher":{"@id":"https:\/\/unihost.com\/help\/#organization"},"keywords":["Docker Registry"],"articleSection":["02. Dedicated servers"],"inLanguage":"en"},{"@type":"WebPage","@id":"https:\/\/unihost.com\/help\/docker-registry\/","url":"https:\/\/unihost.com\/help\/docker-registry\/","name":"Docker Registry - Unihost.FAQ","isPartOf":{"@id":"https:\/\/unihost.com\/help\/#website"},"datePublished":"2025-10-21T07:36:37+00:00","description":"Modern applications often use Docker containers, with images pulled from cloud registries such as Docker Hub or other public sources. However, relying on external services can lead to failures due to registry unavailability. To set up a local storage (registry) for Docker images, you can use a local Docker Registry.","breadcrumb":{"@id":"https:\/\/unihost.com\/help\/docker-registry\/#breadcrumb"},"inLanguage":"en","potentialAction":[{"@type":"ReadAction","target":["https:\/\/unihost.com\/help\/docker-registry\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/unihost.com\/help\/docker-registry\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Unihost","item":"https:\/\/unihost.com\/"},{"@type":"ListItem","position":2,"name":"Help","item":"https:\/\/unihost.com\/help\/"},{"@type":"ListItem","position":3,"name":"Docker Registry"}]},{"@type":"WebSite","@id":"https:\/\/unihost.com\/help\/#website","url":"https:\/\/unihost.com\/help\/","name":"Unihost.FAQ","description":"","publisher":{"@id":"https:\/\/unihost.com\/help\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/unihost.com\/help\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en"},{"@type":"Organization","@id":"https:\/\/unihost.com\/help\/#organization","name":"Unihost","alternateName":"Unihost","url":"https:\/\/unihost.com\/help\/","logo":{"@type":"ImageObject","inLanguage":"en","@id":"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/","url":"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png","contentUrl":"https:\/\/unihost.com\/help\/minio.php?2026\/01\/minio.png","width":300,"height":300,"caption":"Unihost"},"image":{"@id":"https:\/\/unihost.com\/help\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/unihost\/","https:\/\/x.com\/unihost","https:\/\/www.instagram.com\/unihost\/?hl=en","https:\/\/www.linkedin.com\/company\/unihost-com","https:\/\/www.youtube.com\/channel\/UCITKsxMDnslQY8brN3advgw"]},{"@type":"Person","@id":"https:\/\/unihost.com\/help\/#\/schema\/person\/bb5ae95f38577c920e6a7507888b715a","name":"Unihost Support","image":{"@type":"ImageObject","inLanguage":"en","@id":"https:\/\/unihost.com\/help\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/a0c9db17c2a0d93e8a0d5ac123f8c5db750ad4d3d5657369c0c4e480f5af77b8?s=96&d=mm&r=g","caption":"Unihost Support"},"sameAs":["https:\/\/unihost.com\/"],"url":"https:\/\/unihost.com\/help\/author\/support\/"}]}},"_links":{"self":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts\/19337","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/comments?post=19337"}],"version-history":[{"count":2,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts\/19337\/revisions"}],"predecessor-version":[{"id":19339,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/posts\/19337\/revisions\/19339"}],"wp:attachment":[{"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/media?parent=19337"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/categories?post=19337"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/unihost.com\/help\/wp-json\/wp\/v2\/tags?post=19337"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}