Caddy server 2.0.0 / 1.0.5 on Docker Scratch, all in 18MB / 35MB
Caddy server v2.4.1 / v1.0.5 without root, without OS and with optional Caddy plugins
Docker tag | Caddy version | Size | Documentation | CPU architectures |
---|---|---|---|---|
:latest |
v2.4.1 |
37.3MB | ➡️ Setup below | amd64 , 386 , arm64 , armv7 |
:v2.4.1 |
v2.4.1 |
37.5MB | ➡️ Setup below | amd64 , 386 , arm64 , armv7 |
:2.3.0 |
v2.3.0 |
37.3MB | ➡️ Setup below | amd64 , 386 , arm64 , armv7 |
:v2.2.1 |
v2.2.1 |
33.9MB | ➡️ Setup below | amd64 , 386 , arm64 , armv7 |
:v2.1.0 |
v2.1.0 |
39.2MB | ➡️ Wiki link | amd64 , 386 , arm64 , armv7 |
:v2.0.0 |
v2.0.0 |
35.4MB | ➡️ Wiki link | amd64 , 386 , arm64 , armv7 |
:v1.0.5 |
v1.0.5 |
17.2MB | ➡️ Wiki link | amd64 , 386 , arm64 |
:v1.0.4 |
v1.0.4 |
17.3MB | ➡️ Wiki link | amd64 , 386 , arm64 |
Size: uncompressed amd64 built Docker image
✈️ Migrating from v1.0.x? ➡️ Wiki: Migrating
⚠️ The following applies to the :latest
tag. For other Docker tags, refer to the Wiki
docker run -d --name caddy -p 80:8080/tcp -p 443:8443/tcp qmcgaw/caddy-scratch
or use docker-compose.yml with:
docker-compose up -d
The data is persistent in a Docker anonymous volume by default.
By default, this runs using the repository Caddyfile. You could work you way out modifying the Caddy configuration using the Caddy API. Otherwise, if you want to use a Caddyfile, follow these steps.
Create the directory: mkdir caddydir
Create a Caddyfile with the content you would like, in caddydir/Caddyfile
.
Note that at the top of your Caddyfile, there should be at least the following global block:
{
http_port 8080
https_port 8443
}
Change the ownership and permission to match the Docker container
chown -R 1000 caddydir
chmod -R 700 caddydir
If you are on Windows, you may skip this step.
Alternatively, you can run the container with --user="1001"
for example, or as root with --user="root"
(unadvised).
Assuming your current file path is /yourpath
, run the container with:
docker run -d --name caddy -p 80:8080/tcp -p 443:8443/tcp \
-v /yourpath/caddydir:/caddydir qmcgaw/caddy-scratch
If log times are not correct, it's because you need to set your timezone in the TZ
environment variable. For example, add -e TZ=America/Montreal
to your Docker run command.
Update the docker image with docker pull qmcgaw/caddy-scratch
To access the Caddy API, you need:
admin 0.0.0.0:2019
at the top global block (as is in the default Caddyfile)-p 2019:2019/tcp
to your Docker run commandYou need Git installed.
If you want to have for example the github.com/caddyserver/ntlm-transport
plugin, build the image with
docker build -t qmcgaw/caddy \
--build-arg PLUGINS=github.com/caddyserver/ntlm-transport \
https://github.com/qdm12/caddy-scratch.git
Assuming your container is called caddy
, you can reload the Caddyfile with:
docker kill --signal=USR1 caddy
import blockIps