across/docker/caddy/README.md

44 lines
1.4 KiB
Markdown
Raw Normal View History

## Caddy Docker Image by Teddysun
[Caddy][1] is a powerful, enterprise-ready, open source web server with automatic HTTPS written in Go.
Docker images are built for quick deployment in various computing cloud providers.
For more information on docker and containerization technologies, refer to [official document][2].
## Prepare the host
If you need to install docker by yourself, follow the [official installation guide][3].
## Pull the image
```bash
$ docker pull teddysun/caddy
```
This pulls the version **v1.0.5** of Caddy.
It can be found at [Docker Hub][4].
## Start a container
You **must create a configuration file** `/etc/caddy/Caddyfile` in host at first:
```
$ mkdir -p /etc/caddy
```
A sample `Caddyfile` please visit [here](https://github.com/caddyserver/dist/blob/master/config/Caddyfile)
Caddy requires write access to two locations: a [data directory](https://caddyserver.com/docs/conventions#data-directory), and a [configuration directory](https://caddyserver.com/docs/conventions#configuration-directory).
There is an example to override the default `Caddyfile`, you can mount a new one at `/etc/caddy/Caddyfile` like below:
```bash
$ docker run -d -p 80:80 --name caddy --restart=always -v /etc/caddy:/etc/caddy teddysun/caddy
```
[1]: https://caddyserver.com/
[2]: https://docs.docker.com/
[3]: https://docs.docker.com/install/
[4]: https://hub.docker.com/r/teddysun/caddy/