Documentation
a project

Install

This page describes various methods for installing Caddy on your system.

Official:

Community-maintained:

Static binaries

Simply downloading a Caddy binary does not install it as a service, but can be useful in dev or when upgrading an existing installation.

Debian, Ubuntu, Raspbian

Installing this package automatically starts and runs Caddy as a systemd service named caddy, and also comes with a caddy-api service which is not enabled by default, should you need it.

Stable releases:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo tee /etc/apt/trusted.gpg.d/caddy-stable.asc
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Testing releases (includes betas and release candidates):

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/testing/gpg.key' | sudo tee /etc/apt/trusted.gpg.d/caddy-testing.asc
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/testing/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-testing.list
sudo apt update
sudo apt install caddy

View the Cloudsmith repos

If you wish to use the packaged support files (systemd services, bash completion and default configuration) with a custom Caddy build, instructions can be found here.

Fedora, RedHat, CentOS

This package comes with both of Caddy's systemd service unit files, but does not enable them by default.

Fedora or RHEL/CentOS 8:

dnf install 'dnf-command(copr)'
dnf copr enable @caddy/caddy
dnf install caddy

RHEL/CentOS 7:

yum install yum-plugin-copr
yum copr enable @caddy/caddy
yum install caddy

View the Caddy COPR

Arch Linux, Manjaro, Parabola

This package comes with both of Caddy's systemd service unit files, but does not enable them by default.

pacman -Syu caddy

View Caddy in the Arch Linux repositories

Docker

docker pull caddy

View on Docker Hub

DigitalOcean

Deploy a Caddy droplet on DigitalOcean

The droplet is preconfigured to run Caddy as a systemd service via being installed with the apt repo.

Homebrew

Note: This is a community-maintained installation method.

brew install caddy

View the Homebrew formula

Webi

Note: This is a community-maintained installation method.

Linux and macOS:

curl -sS https://webinstall.dev/caddy | bash

Windows:

curl.exe -A MS https://webinstall.dev/caddy | powershell

You may need to adjust the Windows firewall rules to allow non-localhost incoming connections.

View on Webi

Chocolatey

Note: This is a community-maintained installation method.

choco install caddy

View the Chocolatey package

Ansible

Note: This is a community-maintained installation method.

ansible-galaxy install nvjacobo.caddy

View the Ansible role repository

Scoop

Note: This is a community-maintained installation method.

scoop install caddy

View the Scoop manifest

Termux

Note: This is a community-maintained installation method.

pkg install caddy

View the Termux build.sh file