Caddy

Caddy 2 is a powerful, enterprise-ready, open source web server with automatic HTTPS written in Go

Caddy

Caddy used to add Sponsor header and use different license for pre-built binaries
https://www.reddit.com/r/golang/comments/bgz0cd/announcing_caddy_10_caddy_2_and_caddy_enterprise/
Version 2.0 was released in May 2020, seems to have better community support

TODO: remove v1 docs (prior to May 2020)

Caddy - The Ultimate Server with Automatic HTTPS
prebuild library from download page are licensed differently
caddyserver/caddy: Fast and extensible multi-platform HTTP/1-2-3 web server with automatic HTTPS
caddyserver/caddy-docker: Source for the official Caddy v2 Docker Image
caddyserver/dist: Resources for packaging and distributing Caddy systemd unit file

FROM caddy:2-builder-alpine AS builder

RUN xcaddy build \
 --with github.com/greenpau/caddy-auth-jwt \
 --with github.com/greenpau/caddy-auth-portal \
 --with github.com/aksdb/caddy-cgi \
 --with github.com/abiosoft/caddy-json-parse \
 --with github.com/greenpau/caddy-trace \
 --with github.com/RussellLuo/caddy-ext/ratelimit \
 --with github.com/chukmunnlee/caddy-openapi \
 --with github.com/lucaslorentz/caddy-docker-proxy/plugin \
 --with github.com/casbin/caddy-authz \
 --with github.com/mholt/caddy-l4 \
 --with github.com/mholt/caddy-ratelimit

FROM caddy:2-alpine

# overwrites caddy with my custom build
COPY --from=builder /usr/bin/caddy /usr/bin/caddy

https://caddyserver.com/download?\
  package=github.com%2Fgreenpau%2Fcaddy-auth-jwt&\
  package=github.com%2Fgreenpau%2Fcaddy-auth-portal&\
  package=github.com%2Faksdb%2Fcaddy-cgi%2Fv2&\
  package=github.com%2Fabiosoft%2Fcaddy-json-parse&\
  package=github.com%2Fgreenpau%2Fcaddy-trace&\
  package=github.com%2FRussellLuo%2Fcaddy-ext%2Fratelimit&\
  package=github.com%2Fchukmunnlee%2Fcaddy-openapi&\
  package=github.com%2Flucaslorentz%2Fcaddy-docker-proxy%2Fplugin%2Fv2&\
  package=github.com%2Fcasbin%2Fcaddy-authz%2Fv2&\
  package=github.com%2Fmholt%2Fcaddy-l4&\
  package=github.com%2Fmholt%2Fcaddy-ratelimit

Welcome — Caddy Documentation
Getting Started — Caddy Documentation
Upgrading to Caddy 2 — Caddy Documentation
Caddy Community
Top Wiki topics - Caddy Community

Anyone else dislike v2? - Help - Caddy Community
For Mastodon Caddy Setting file. (Based on official Nginx configuration example) [Last Update: May 16, 2020] v1 -> v2
Upgrading to Caddy 2 — Caddy Documentation

Caddy offers TLS, HTTPS, and more in one dependency-free Go Web server – Ars Technica

Troubleshooting

see ssl-tls.md#ssl-checkers

Do check SSL cert with SSL checkers as browser may allow revoked cert due to caching, but some anti-virus software will block it.

In case of Caddy not renewing revoked certificate, remove ~/.local/share/caddy/certificates/acme-v02.api.letsencrypt.org-directory/<domain> manually.

Config

Caddyfile Quick-start — Caddy Documentation
Caddyfile Tutorial — Caddy Documentation
The Caddyfile — Caddy Documentation
Caddyfile Concepts — Caddy Documentation

API Quick-start — Caddy Documentation
API — Caddy Documentation

JSON Config Structure - Caddy Documentation

Command Line — Caddy Documentation

caddy run --config /path/to/Caddyfile
caddy start --config /path/to/Caddyfile  # in background
caddy file-server browse

Top Wiki topics - Caddy Community
So You Want to Write a Caddyfile - Wiki - Caddy Community
Composing in the Caddyfile - Wiki - Caddy Community

# OBSOLETE v1 instructions
curl https://getcaddy.com | bash -s personal http.cors,http.expires,http.filemanager,http.filter,http.forwardproxy,http.git,http.hugo,http.jwt,http.locale,http.login,http.minify

mkdir caddy; cd caddy
wget https://caddyserver.com/download/linux/amd64 -O caddy_linux_amd64.tar.gz
tar xzf caddy_linux_amd64.tar.gz

./caddy browse -log ./log -port 80 -root <WWW_ROOT>

Caddy

Caddy

Troubleshooting

Config

CORS

Videos

Docker

Module/Plugin

Tips and Tricks

v1