Awesome
Caddy Server on Alpine Linux
This is a Docker image for Caddyserver. This image runs with a base of Alpine-Linux making it extremely small, secure and fast.
This image can also be found on Docker Hub.
Usage
We recommend using our images in conjunction with Docker-Compose. This allows for easier creation of containers with the proper volumes and ports enabled.
We have included an example docker-compose file for use in a real project.
This image works with two defaults
- A default Caddyfile
- A default location inside the container for static files: /var/www/html
In order to use this image, we recommend running it with a volume connecting your static files to the root location of the docker file:
docker run -d -p 80:80 -v $(pwd)/public:/var/www/html zzrot/alpine-caddy
The server will be available at your.docker.machine.ip.
This is the bare minimum needed to use this image. Although further customization is made easier with a docker-compose file.
The benefits of building an image with a overrideable Caddyfile are that you can include your own by including another volume. To see a fully configured docker-compose file see this example.
For writing a custom Caddyfile please read this.
Middleware
Alpine-Caddy includes all Caddy Middleware and features. You can read more on these specific features in the Caddy User Guide.
Caddy as a reverse proxy
This image can also effectively be used as a reverse proxy. Included in the examples/ folder is an example Caddyfile.
The example docker-compose shows how to include your custom Caddyfile as a volume as well as an example proxy set up with containers.
Volumes
Alpine-Caddy has three locations where volumes can be linked to.
Static Files
In order to serve static content, alpine-caddy needs to be able to access your static files from inside of the container. To do this, link the directory of your static files with /var/www/html inside of the container.
For docker-compose.yml files, under the volumes declaration, include:
- ./public:/var/www/html
or
docker run -v $(pwd)/public:/var/www/html
Custom Caddyfile
To upload a custom Caddyfile, link your Caddyfile to the directory /etc/Caddyfile in the container. For docker-compose.yml files, under the volumes declaration, include:
- ./Caddyfile:/etc/Caddyfile
or
docker run -v $(pwd)/Caddyfile:/etc/Caddyfile zzrot/alpine-caddy
Certificate Persistance
If you use alpine-caddy to generate SSL certificates from Let's Encrypt, you should persist those certificates outside of the container. In the instance of a container failure, this allows the container to reuse the same certificates, instead of generating new ones from Let's Encrypt.
For information on including this into your Caddyfile see the Caddyfile tls specification.
The certificates are stored in /root/.caddy inside of the container, and thus you must connect an outside directory to that directory to allow persistance. For docker-compose.yml files, under the volumes declaration, include:
- ./.caddy:/root/.caddy
or
docker run -v $(pwd)/.caddy:/root/.caddy
Contributing to Alpine-Caddy
Team members
Don't hesitate to get in contact with either one of us with problems, questions, etc.
Adding new features
- Fork it!
- Create your feature branch: git checkout -b my-new-feature
- Commit your changes: git commit -am 'Add some feature'
- Push to the branch: git push origin my-new-feature
- Submit a pull request :D
Don’t get discouraged! We estimate that the response time from the maintainers is around: 24 hours.
Reporting Security Issues
If you discover a security issue in this Docker image, please report it by sending an email to docker@zzrot.com
This will allow us to assess the risk, and make a fix available before we add a bug report to the GitHub repository.
Thanks for helping make this image safe for everyone!
License
The code is available under the MIT License.