Fast, cross-platform HTTP/2 web server with automatic HTTPS
Latest commit 13f9c34 Sep 18, 2018
Permalink
Failed to load latest commit information.
.github Update contributing instructions related to docs Apr 2, 2018
caddy Ensure assets path exists before writing UUID file Aug 26, 2018
caddyfile caddyfile: Fix multi-file snippets and import literals. (#2205) Jun 28, 2018
caddyhttp fastcgi: Add default timeouts (#2265) Sep 2, 2018
caddytls caddytls: gofmt (Go 1.11) (#2241) Aug 24, 2018
dist init: Fix configuration permissions in systemd integration. (#2130) Jun 19, 2018
onevent onevent/startupshutdown: run command once per server block (#1934) Oct 22, 2017
telemetry telemetry: Use int64 constant for duration interval May 10, 2018
vendor update to quic-go v0.10.0 (#2288) Sep 2, 2018
.gitattributes Catch whitespace code style violations locally (#774) Apr 20, 2016
.gitignore gitignore: Don't ignore the caddyfile/ package (#2237) (#2238) Jul 26, 2018
.travis.yml Update CI to use Go 1.11 Aug 24, 2018
LICENSE.txt License is a text file Aug 1, 2015
README.md Fix broken link to sourcegraph in README (#2285) Sep 7, 2018
appveyor.yml Fix AppVeyor builds (#2289) Sep 7, 2018
assets.go Apply Apache license to all .go source files (closes #1865) Sep 23, 2017
assets_test.go improve error checking (#1938) Oct 31, 2017
caddy.go Fix deadlock, ensure instances mutex unlocked (#2296) Sep 18, 2018
caddy_test.go Apply Apache license to all .go source files (closes #1865) Sep 23, 2017
commands.go Apply Apache license to all .go source files (closes #1865) Sep 23, 2017
commands_test.go Apply Apache license to all .go source files (closes #1865) Sep 23, 2017
controller.go tls: Restructure and improve certificate management Feb 4, 2018
plugins.go core: instance restart (reload) event (#2178) Jun 12, 2018
rlimit_nonposix.go Apply Apache license to all .go source files (closes #1865) Sep 23, 2017
rlimit_posix.go rlimit_posix.go: Use backticks for shell code (#2235) Jul 26, 2018
sigtrap.go Refactor diagnostics -> telemetry Mar 23, 2018
sigtrap_nonposix.go Apply Apache license to all .go source files (closes #1865) Sep 23, 2017
sigtrap_posix.go core: instance restart (reload) event (#2178) Jun 12, 2018
upgrade.go improve error checking (#1938) Oct 31, 2017

README.md

Caddy

Every Site on HTTPS

Caddy is a general-purpose HTTP/2 web server that serves HTTPS by default.


@caddyserver on Twitter Caddy Forum Caddy on Sourcegraph

Download · Documentation · Community


Caddy is a production-ready open-source web server that is fast, easy to use, and makes you more productive.

Available for Windows, Mac, Linux, BSD, Solaris, and Android.

Menu

Features

  • Easy configuration with the Caddyfile
  • Automatic HTTPS on by default (via Let's Encrypt)
  • HTTP/2 by default
  • Virtual hosting so multiple sites just work
  • Experimental QUIC support for cutting-edge transmissions
  • TLS session ticket key rotation for more secure connections
  • Extensible with plugins because a convenient web server is a helpful one
  • Runs anywhere with no external dependencies (not even libc)

See a more complete list of features built into Caddy. On top of all those, Caddy does even more with plugins: choose which plugins you want at download.

Altogether, Caddy can do things other web servers simply cannot do. Its features and plugins save you time and mistakes, and will cheer you up. Your Caddy instance takes care of the details for you!

Install

Caddy binaries have no dependencies and are available for every platform. Get Caddy either of these ways:

Build

To build from source you need Git and Go (1.10 or newer). Follow these instruction for fast building:

  • Get the source with go get github.com/mholt/caddy/caddy and then run go get github.com/caddyserver/builds
  • Now cd $GOPATH/src/github.com/mholt/caddy/caddy and run go run build.go

Then make sure the caddy binary is in your PATH.

To build for other platforms, use build.go with the --goos and --goarch flags.

When building from source, telemetry is enabled by default. You can disable it by changing enableTelemetry in run.go before compiling, or use the -disabled-metrics flag at runtime to disable only certain metrics.

Quick Start

To serve static files from the current working directory, run:

caddy

Caddy's default port is 2015, so open your browser to http://localhost:2015.

Go from 0 to HTTPS in 5 seconds

If the caddy binary has permission to bind to low ports and your domain name's DNS records point to the machine you're on:

caddy -host example.com

This command serves static files from the current directory over HTTPS. Certificates are automatically obtained and renewed for you! Caddy is also automatically configuring ports 80 and 443 for you, and redirecting HTTP to HTTPS. Cool, huh?

Customizing your site

To customize how your site is served, create a file named Caddyfile by your site and paste this into it:

localhost

push
browse
websocket /echo cat
ext    .html
log    /var/log/access.log
proxy  /api 127.0.0.1:7005
header /api Access-Control-Allow-Origin *

When you run caddy in that directory, it will automatically find and use that Caddyfile.

This simple file enables server push (via Link headers), allows directory browsing (for folders without an index file), hosts a WebSocket echo server at /echo, serves clean URLs, logs requests to an access log, proxies all API requests to a backend on port 7005, and adds the coveted Access-Control-Allow-Origin: * header for all responses from the API.

Wow! Caddy can do a lot with just a few lines.

Doing more with Caddy

To host multiple sites and do more with the Caddyfile, please see the Caddyfile tutorial.

Sites with qualifying hostnames are served over HTTPS by default.

Caddy has a nice little command line interface. Run caddy -h to view basic help or see the CLI documentation for details.

Running in Production

Caddy is production-ready if you find it to be a good fit for your site and workflow.

Running as root: We advise against this. You can still listen on ports < 1024 on Linux using setcap like so: sudo setcap cap_net_bind_service=+ep ./caddy

The Caddy project does not officially maintain any system-specific integrations nor suggest how to administer your own system. But your download file includes unofficial resources contributed by the community that you may find helpful for running Caddy in production.

How you choose to run Caddy is up to you. Many users are satisfied with nohup caddy &. Others use screen. Users who need Caddy to come back up after reboots either do so in the script that caused the reboot, add a command to an init script, or configure a service with their OS.

If you have questions or concerns about Caddy' underlying crypto implementations, consult Go's crypto packages, starting with their documentation, then issues, then the code itself; as Caddy uses mainly those libraries.

Contributing

Join our forum where you can chat with other Caddy users and developers! To get familiar with the code base, try Caddy code search on Sourcegraph!

Please see our contributing guidelines for instructions. If you want to write a plugin, check out the developer wiki.

We use GitHub issues and pull requests only for discussing bug reports and the development of specific changes. We welcome all other topics on the forum!

If you want to contribute to the documentation, please submit an issue describing the change that should be made.

Thanks for making Caddy -- and the Web -- better!

Donors

  • DigitalOcean is hosting the Caddy project.
  • DNSimple provides DNS services for Caddy's sites.
  • DNS Spy keeps an eye on Caddy's DNS properties.

We thank them for their services. If you want to help keep Caddy free, please become a sponsor!

About the Project

Caddy was born out of the need for a "batteries-included" web server that runs anywhere and doesn't have to take its configuration with it. Caddy took inspiration from spark, nginx, lighttpd, Websocketd and Vagrant, which provides a pleasant mixture of features from each of them.

The name "Caddy" is trademarked: The name of the software is "Caddy", not "Caddy Server" or "CaddyServer". Please call it "Caddy" or, if you wish to clarify, "the Caddy web server". See brand guidelines. Caddy is a registered trademark of Light Code Labs, LLC.

Author on Twitter: @mholt6