update readme
This commit is contained in:
parent
5572eace36
commit
23a3bdbd50
1 changed files with 49 additions and 0 deletions
49
README.md
Normal file
49
README.md
Normal file
|
@ -0,0 +1,49 @@
|
||||||
|
This container provides fully automated SSL containers in IPv6
|
||||||
|
networks
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
You need to have docker configured to use IPv6. The following code can
|
||||||
|
be placed in /etc/docker/daemon.json:
|
||||||
|
|
||||||
|
```
|
||||||
|
{
|
||||||
|
"ipv6": true,
|
||||||
|
"fixed-cidr-v6": "2001:db8::/64"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
You need to replace "2001:db8::/64" with your own IPv6 network.
|
||||||
|
|
||||||
|
Read more about [enabling IPv6 in docker](https://ungleich.ch/u/blog/how-to-enable-ipv6-in-docker/).
|
||||||
|
|
||||||
|
## How it works
|
||||||
|
|
||||||
|
IPv6 addresses are globally reachable, so IPv6 based containers can be
|
||||||
|
reached from anywhere in the world.
|
||||||
|
|
||||||
|
This container uses the domain **has-a.name**, which gives a
|
||||||
|
name to every IPv6 address.
|
||||||
|
|
||||||
|
Checkout how
|
||||||
|
[has-a.name](https://ungleich.ch/u/blog/has-a-name-for-every-ipv6-address/) works.
|
||||||
|
|
||||||
|
## How to use
|
||||||
|
|
||||||
|
Start the container and use the logs to gets its domain name:
|
||||||
|
|
||||||
|
```
|
||||||
|
id=$(docker run -d ungleich/nginx-letsencrypt-ipv6)
|
||||||
|
docker logs ${id} 2>/dev/null | grep "^Getting certificate"
|
||||||
|
Getting certificate for 2a0a-e5c1-0111-0777-0000-0242-ac11-0004.has-a.name
|
||||||
|
```
|
||||||
|
|
||||||
|
With this information, you can now connect to your container:
|
||||||
|
```
|
||||||
|
% curl https://2a0a-e5c1-0111-0777-0000-0242-ac11-0004.has-a.name
|
||||||
|
Welcome to 2a0a-e5c1-0111-0777-0000-0242-ac11-0004.has-a.name running with IPv6+LetsEncrypt
|
||||||
|
```
|
||||||
|
|
||||||
|
## How to extend it
|
||||||
|
|
||||||
|
TBD
|
Loading…
Reference in a new issue