# Instalación de Caddy en Debian

- Link: https://binariocero.com/linux/instalacion-de-caddy-en-debian
- Published: 2026-02-27T10:54:28+01:00
- Author: Juan José Fernández Durán

![Loading](https://binariocero.com/wp-content/plugins/page-views-count/ajax-loader-
2x.gif)

**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:

    ```wp-block-preformatted
    sudo apt install -y debian-keyring debian-archive-keyring apt-transport-httpscurl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpgcurl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.listsudo apt updatesudo apt install caddy
    ```

**Explicación rápida:**

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

## Verificación de la Instalación

Comprueba que Caddy se ha instalado correctamente:

    ```wp-block-preformatted
    caddy version
    ```

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

    ```wp-block-preformatted
    v2.x.x
    ```

## Configuración Inicial

 1. **Crear un Caddyfile básico**:

    ```wp-block-preformatted
    sudo nano /etc/caddy/Caddyfile
    ```

Ejemplo mínimo:

    ```wp-block-preformatted
    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.

 2. **Recargar Caddy tras cambios**:

    ```wp-block-preformatted
    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:

    ```wp-block-preformatted
    sudo ufw allow 80,443/tcpsudo ufw reload
    ```

## Actualización de Caddy

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

    ```wp-block-preformatted
    sudo apt updatesudo apt upgrade caddy -y
    ```

## Desinstalación

Para desinstalar Caddy:

    ```wp-block-preformatted
    sudo systemctl stop caddysudo apt remove --purge caddy -ysudo rm /etc/apt/sources.list.d/caddy-stable.listsudo rm /usr/share/keyrings/caddy-stable-archive-keyring.gpg
    ```

## Recursos Adicionales

 * Documentación oficial: [Caddy Documentation](https://caddyserver.com/docs)
 * Comunidad: [Caddy Community Forum](https://caddy.community/)