Instalación de Caddy en Debian

by Juan José Fernández Durán · 27 de febrero de 2026

Caddy es un servidor web y proxy inverso con soporte automático para HTTPS mediante Let's Encrypt, HTTP/3 y fácil configuración a través de un único archivo Caddyfile.
Este manual explica cómo instalar Caddy en Debian utilizando el repositorio oficial.

Requisitos Previos

Antes de instalar Caddy, asegúrate de tener:

Sistema Debian actualizado.
Usuario con privilegios sudo.
Conexión a Internet.
Puertos libres:
- 80/TCP (HTTP)
- 443/TCP (HTTPS)

Instalación de Dependencias y Repositorio

Ejecuta los siguientes comandos en orden:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
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

Explicación rápida:

debian-keyring, debian-archive-keyring y apt-transport-https permiten manejar repositorios seguros vía HTTPS.
Los comandos curl descargan la clave GPG de Caddy y la configuran para que APT confíe en el repositorio.
Se agrega el repositorio oficial de Caddy a APT.
Se actualizan los paquetes y se instala Caddy.

Verificación de la Instalación

Comprueba que Caddy se ha instalado correctamente:

caddy version

Debería devolver la versión instalada, algo como:

v2.x.x

Configuración Inicial

Crear un Caddyfile básico:

sudo nano /etc/caddy/Caddyfile

Ejemplo mínimo:

example.com {
    root * /var/www/html
    file_server
}

example.com → reemplaza con tu dominio real.
root * /var/www/html → ruta a tus archivos web.
file_server → habilita la entrega de archivos.

Recargar Caddy tras cambios:

sudo systemctl reload caddy

Administración del Servicio

Iniciar Caddy: sudo systemctl start caddy
Habilitar al arranque: sudo systemctl enable caddy
Detener Caddy: sudo systemctl stop caddy
Estado del servicio: sudo systemctl status caddy

Configuración de Firewall

Si tienes ufw activo, permite tráfico HTTP y HTTPS:

sudo ufw allow 80,443/tcp
sudo ufw reload

Actualización de Caddy

Para actualizar a la última versión desde el repositorio oficial:

sudo apt update
sudo apt upgrade caddy -y

Desinstalación

Para desinstalar Caddy:

sudo systemctl stop caddy
sudo apt remove --purge caddy -y
sudo rm /etc/apt/sources.list.d/caddy-stable.list
sudo rm /usr/share/keyrings/caddy-stable-archive-keyring.gpg