https://github.com/mrdvince/docker_self_hosted_registry
docker custom/private registry config, images stored on an AWS S3 bucket, ssl and traefik as the reverse proxy.
https://github.com/mrdvince/docker_self_hosted_registry
aws-s3 docker docker-registry-v2 poxy-server traefik
Last synced: 14 days ago
JSON representation
docker custom/private registry config, images stored on an AWS S3 bucket, ssl and traefik as the reverse proxy.
- Host: GitHub
- URL: https://github.com/mrdvince/docker_self_hosted_registry
- Owner: mrdvince
- Created: 2021-10-20T04:40:59.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2021-10-23T10:42:43.000Z (almost 5 years ago)
- Last Synced: 2025-10-30T00:34:25.370Z (9 months ago)
- Topics: aws-s3, docker, docker-registry-v2, poxy-server, traefik
- Homepage:
- Size: 3.91 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker self hosted registry
> Why host you own registry? Well it's free"ish" compared to hosting your images on docker hub, plus you can just use cloud credits if you have them. Now you can just pull your own images into your Kubernetes cluster etc.
## Getting started
1. Clone the repo and cd into the cloned folder.
```bash
https://github.com/mrdvince/docker_self_hosted_registry.git
cd docker_self_hosted_registry
```
2. Generate a password
```bash
docker run \
--entrypoint htpasswd \
httpd:2 -Bbn registry regtoor > auth/htpasswd
```
> docker registry supports other auth methods you can check those out in the docker docs.
3. Create an AWS S3 bucket, user & policy
3a. Create an AWS bucket
3b. Create a policy, copy the below json replacing the `bucket_name` with your bucket name
```json
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": "arn:aws:s3:::*"
},
{
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation",
"s3:ListBucketMultipartUploads"
],
"Resource": "arn:aws:s3:::"
},
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:ListMultipartUploadParts",
"s3:AbortMultipartUpload"
],
"Resource": "arn:aws:s3:::/*"
}
]
}
```
3c. Assign this policy to the IAM user created.
4. Download user creds and replace the fields in the `config.yml` file
5. Start the services
```bash
docker-compose up -d
```
## Usage/Testing
1. Login to the registry
```bash
docker login
```
2. Pull an image from docker hub, tag it and push it to the self hosted registry
```bash
# pull an image from docker hub
docker pull ubuntu
# tag the image so that it points to the self hosted registry
docker image tag ubuntu domain.com/myfirstimage
# push it
docker push domain.com/myfirstimage
# pull it back
docker pull domain.com/myfirstimage
```
Voilà