Public Repository

Last pushed: 12 hours ago
Short Description web server in a tiny docker container based on alpine linux
Full Description

Caddy web server


This project:
Docker image:
Upstream Caddy:


This git repo downloads golang source code from and builds a small docker image.

See and to learn about Caddy.


The following plugins are installed in the image:

See fixtures/caddyfile
for an example config used to test this image.


in this git repo.



:warning: Build requires Docker 1.9.0 or later (for docker build args).

make all

The above command builds a caddybuild image, which builds
a static binary. It then copies the static binary
out of the build image and creates a runtime image, caddy.

The runtime image does not have developer tools or source code.
The runtime image is based on Alpine, not Scratch, to enable
plugins that depend on external tools, such as git.


We use circleci to build, test, and publish the image to Docker hub.
We use BATS to run the test harness.

Output of make test resembles:

✓ caddy image exists
✓ caddy is running on the test port
✓ git plugin is installed
✓ git plugin works
✓ caddy binary is stripped
✓ caddy binary is statically compiled
✓ upload plugin is present
✓ upload works

8 tests, 0 failures

Pull an already-built image

# Note: build tags follow the pattern
# jumanjiman/caddy:${CADDY_VERSION}-${BUILD_DATE}T${BUILD_TIME}-git-${HASH}
docker pull jumanjiman/caddy

View labels

Each built image has labels that generally follow

We add a label, ci-build-url, that is not currently part of the schema.
This extra label provides a permanent link to the CI build for the image.

View the ci-build-url label on a built image:

docker inspect \
  -f '{{ index .Config.Labels "" }}' \

Query all the labels inside a built image:

docker inspect jumanjiman/caddy | jq -M '.[].Config.Labels'


Create a config in some directory on your host, then:

docker run -d \
-p 2020:2020 \
--name caddy \
-v /path/to/configdir:/etc/caddy \
--read-only \
--cap-drop all \
jumanjiman/caddy -conf /etc/caddy/caddyfile
Docker Pull Command