Skip to content
Runbook

Install Caddy on Arch

Modern web server with automatic HTTPS, usable as a reverse proxy and file server.

Toolweb-serverreverse-proxyhttpstlshttp

Installation

Caddy (Arch repositories) · pacman
sudo pacman -S caddy

Installs the caddy binary and a systemd service.

Verify the installation

Verify
caddy version

Service

Start
sudo systemctl start caddy
Stop
sudo systemctl stop caddy
Status
sudo systemctl status caddy
Restart
sudo systemctl restart caddy
On boot
sudo systemctl enable caddy

Important files

TypePathDescription
config/etc/caddy/CaddyfileMain configuration file read by the systemd service.
data/var/lib/caddyState directory where TLS certificates are stored.

Default ports

80443

Command-line tools

  • caddyServer and CLI; the package also installs the caddy systemd unit.

Uninstall

Uninstall
sudo systemctl stop caddy
sudo pacman -Rs caddy

Good to know

  • Caddy is in the official Arch repositories (extra); no AUR needed.
  • Edit /etc/caddy/Caddyfile, then apply with sudo systemctl reload caddy.
  • Certificates and state live under /var/lib/caddy.

Installation on Arch Linux

sudo pacman -S caddy installs the binary and a systemd service from the official extra repository — no AUR required. Enable and start it with sudo systemctl enable --now caddy.

Configuration

The service reads /etc/caddy/Caddyfile. After editing it, apply changes with sudo systemctl reload caddy, which reloads the configuration without dropping connections.

Certificates and state

Automatically issued TLS certificates and Caddy's state are stored under /var/lib/caddy. Preserve this directory across reinstalls to avoid re-issuing certificates and hitting rate limits.