This image uses the old Caddy v1, Caddy 2 is out and now has an offical container. I won't be updating this image to v2.
A Docker image for Caddy. This image includes the git and cloudflare plugins. Plugins can also be configured via the plugins
build arg.
A big thank you to abiosoft whos this image is forked off.
Telemetry has been enabled by default on this image! If you do not want this please use another docker image.
$ docker run -d -p 2015:2015 adriel/caddy
Point your browser to http://127.0.0.1:2015
.
Be aware! If you don't bind mount the location certificates are saved to, you may hit Let's Encrypt rate limits rending further certificate generation or renewal disallowed (for a fixed period)! See "Saving Certificates" below!
Save certificates on host machine to prevent regeneration every time container starts. Let's Encrypt has rate limit.
$ docker run -d \
-v $(pwd)/Caddyfile:/etc/Caddyfile \
-v $HOME/.caddy:/root/.caddy \
-p 80:80 -p 443:443 \
adriel/caddy
Here, /root/.caddy
is the location inside the container where Caddy will save certificates.
Additionally, you can use an environment variable to define the exact location Caddy should save generated certificates:
$ docker run -d \
-e "CADDYPATH=/etc/caddycerts" \
-v $HOME/.caddy:/etc/caddycerts \
-p 80:80 -p 443:443 \
adriel/caddy
Above, we utilize the CADDYPATH
environment variable to define a different location inside the container for
certificates to be stored. This is probably the safest option as it ensures any future docker image changes don't interfere with your ability to save certificates!
:[<version>-]php
variant of this image bundles PHP-FPM alongside essential php extensions and composer. e.g. :php
, :0.10-php
$ docker run -d -p 2015:2015 adriel/caddy:php
Point your browser to http://127.0.0.1:2015
and you will see a php info page.
Replace /path/to/php/src
with your php sources directory.
$ docker run -d -v /path/to/php/src:/srv -p 2015:2015 adriel/caddy:php
Point your browser to http://127.0.0.1:2015
.
Your Caddyfile
must include the line on startup php-fpm7
. For Caddy to be PID 1 in the container, php-fpm7 could not be started.
Caddy can talk to Cloudflare via their API to automaticly confugure/update your Let's Encrypt certificates using the Cloudflare plugin (which has been included in this image).
Follow the instrutions here to set it up.
Caddy can serve sites from git repository using git plugin.
Replace github.com/adriel/webtest
with your repository.
$ printf "0.0.0.0\nroot src\ngit github.com/adriel/webtest" > Caddyfile
$ docker run -d -v $(pwd)/Caddyfile:/etc/Caddyfile -p 2015:2015 abiosoft/caddy
Point your browser to http://127.0.0.1:2015
.
The image contains a default Caddyfile.
0.0.0.0
browse
fastcgi / 127.0.0.1:9000 php # php variant only
startup php-fpm7 # php variant only
The last 2 lines are only present in the php variant.
Caddyfile: /etc/Caddyfile
Sites root: /srv
Replace /path/to/Caddyfile
and /path/to/sites/root
accordingly.
$ docker run -d \
-v /path/to/sites/root:/srv \
-v path/to/Caddyfile:/etc/Caddyfile \
-p 2015:2015 \
abiosoft/caddy
Note that this does not work on local environments.
Use a valid domain and add email to your Caddyfile to avoid prompt at runtime.
Replace mydomain.com
with your domain and [email protected]
with your email.
mydomain.com
tls [email protected]
You can change the the ports if ports 80 and 443 are not available on host. e.g. 81:80, 444:443
$ docker run -d \
-v $(pwd)/Caddyfile:/etc/Caddyfile \
-p 80:80 -p 443:443 \
abiosoft/caddy