{"id":31904375,"url":"https://github.com/cloudfoundry-community/docker-registry-boshrelease","last_synced_at":"2025-10-13T13:49:26.936Z","repository":{"id":14054533,"uuid":"16757424","full_name":"cloudfoundry-community/docker-registry-boshrelease","owner":"cloudfoundry-community","description":"Run your own private Docker Registry in standalone mode (without requiring the public index) on AWS, OpenStack or vSphere with BOSH","archived":false,"fork":false,"pushed_at":"2022-10-03T19:16:43.000Z","size":229,"stargazers_count":13,"open_issues_count":5,"forks_count":21,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-04-14T22:47:40.096Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudfoundry-community.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-02-12T05:47:38.000Z","updated_at":"2024-02-09T14:25:49.000Z","dependencies_parsed_at":"2022-08-07T07:16:12.339Z","dependency_job_id":null,"html_url":"https://github.com/cloudfoundry-community/docker-registry-boshrelease","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/cloudfoundry-community/docker-registry-boshrelease","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fdocker-registry-boshrelease","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fdocker-registry-boshrelease/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fdocker-registry-boshrelease/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fdocker-registry-boshrelease/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudfoundry-community","download_url":"https://codeload.github.com/cloudfoundry-community/docker-registry-boshrelease/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudfoundry-community%2Fdocker-registry-boshrelease/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279015347,"owners_count":26085686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-13T13:48:48.316Z","updated_at":"2025-10-13T13:49:26.927Z","avatar_url":"https://github.com/cloudfoundry-community.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Private Docker Registry deployed with BOSH\n\nRun your own private Docker Registry in standalone mode (without requiring the public index).\n\n## Simple deployment with internal DNS\n\nThe default deployment manifest will create an internal DNS hostname `docker-registry.bosh` for clients to use.\n\n```plain\nbosh -d docker-registry deploy manifests/docker-registry.yml\n```\n\nNow fetch the self-signed root CA, and the admin basic-auth password, and store in local files:\n\n```plain\ncredhub get -n /bucc/docker-registry/docker_registry_certificate -j \\\n    | jq -r \".value.ca\" \u003e registry-ca.pem\ncredhub get -n /bucc/docker-registry/docker_registry_password -j \\\n    | jq -r \".value\" \u003e registry-password\n```\n\nWe can test out our registry from within the registry's own instance. First, upload our secrets:\n\n```plain\nbosh scp registry-ca.pem registry-password docker-registry:/tmp/\n```\n\nNext, SSH into the instance:\n\n```plain\nbosh -d docker-registry ssh\n```\n\nWe can now interact with the Registry via its API and its DNS alias `docker-registry.bosh`:\n\n```plain\n$ curl https://docker-registry.bosh/v2/_catalog -u \"admin:$(cat /tmp/password)\" --cacert /tmp/ca.pem\n{\"repositories\":[]}\n```\n\n## Expose Docker Registry via Static IP\n\nDelete the TLS certificate for the Docker Registry, so that a new one will be generated that includes both the new static IP, and the `docker-registry.bosh` hostname:\n\n```plain\ncredhub delete -n /bucc/docker-registry/docker_registry_certificate\n```\n\nSelect an available static IP from the Cloud Config. We'll use 10.244.0.34 below, and re-deploy the Docker Registry with the `manifests/operators/static-ip.yml` operator file:\n\n```plain\nbosh -d docker-registry deploy manifests/docker-registry.yml \\\n    -o manifests/operators/static-ip.yml \\\n    -v ip=10.244.0.34\n```\n\nNow add `registry-ca.pem` to system CA (please let use know if there's a way for `docker login` to consume a local self-signed CA). For example, in Keychain it may look like:\n\n![keychain](https://p198.p4.n0.cdn.getcloudapp.com/items/p9u5lR81/docker-registry-ca-keychain.png?v=0a5b64b4ab0ebf3538ad61d35d45557f)\n\nWe can now `docker login` to our registry, tag `ubuntu:latest` as `10.244.0.34/ubuntu` and push it to our registry:\n\n```bash\ndocker login -u admin -p \"$(cat registry-password)\" 10.244.0.34\ndocker tag ubuntu 10.244.0.34/ubuntu\ndocker push 10.244.0.34/ubuntu\n```\n\nOur registry API confirms it now has the `ubuntu` image:\n\n```plain\n$ curl https://10.244.0.34/v2/_catalog -u \"admin:$(cat registry-password)\"\n{\"repositories\":[\"ubuntu\"]}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Fdocker-registry-boshrelease","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudfoundry-community%2Fdocker-registry-boshrelease","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudfoundry-community%2Fdocker-registry-boshrelease/lists"}