Installazione

Questa pagina descrive vari metodi per installare Caddy sul vostro sistema.

Ufficiali:

Gestiti dalla comunità:

Binari statici

Se state installando su un sistema di produzione, raccomandiamo di usare il pacchetto ufficiale per la vostra distribuzione, se disponibile di seguito.

  1. Ottenete un binario di Caddy:
  2. Installate Caddy come servizio di sistema. Questo è caldamente raccomandato, specialmente per i server di produzione.

Posizionate il binario in una delle directory del vostro $PATH (o %PATH% su Windows) in modo da poter eseguire caddy senza digitare il percorso completo del file eseguibile. (Eseguite echo $PATH per vedere l'elenco delle directory idonee.)

Potete aggiornare i binari statici sostituendoli con versioni più recenti e riavviando Caddy. Il comando caddy upgrade può facilitare questa operazione.

Debian, Ubuntu, Raspbian

L'installazione di questo pacchetto avvia ed esegue automaticamente Caddy come servizio systemd chiamato caddy. Include anche un servizio opzionale caddy-api che non è abilitato per impostazione predefinita, ma dovrebbe essere utilizzato se configurate Caddy principalmente tramite la sua API invece dei file di configurazione.

Dopo l'installazione, leggete le istruzioni sull'uso del servizio.

Release stabili:

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
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 chmod o+r /usr/share/keyrings/caddy-stable-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install caddy

Release di test (include beta e release candidate):

sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/testing/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-testing-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/testing/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-testing.list
sudo chmod o+r /usr/share/keyrings/caddy-testing-archive-keyring.gpg
sudo chmod o+r /etc/apt/sources.list.d/caddy-testing.list
sudo apt update
sudo apt install caddy

Visualizza i repository Cloudsmith

Se desiderate utilizzare i file di supporto del pacchetto (servizi systemd, completamento bash e configurazione predefinita) con una build personalizzata di Caddy, le istruzioni si trovano qui.

Fedora, RedHat, CentOS

Questo pacchetto include entrambi i file delle unità del servizio systemd di Caddy, ma non li abilita per impostazione predefinita. L'uso del servizio è raccomandato. In tal caso, leggete le istruzioni sull'uso del servizio.

Fedora:

dnf install dnf5-plugins
dnf copr enable @caddy/caddy
dnf install caddy

CentOS/RHEL:

dnf install dnf-plugins-core
dnf copr enable @caddy/caddy
dnf install caddy

Visualizza il COPR di Caddy

Arch Linux, Manjaro, Parabola

Questo pacchetto include versioni pesantemente modificate di entrambi i file delle unità del servizio systemd di Caddy, ma non li abilita per impostazione predefinita. Tali modifiche includono un comportamento di avvio/arresto personalizzato e flag di sandboxing aggiuntivi spiegati nella documentazione exec di systemd, che potrebbero rendere alcune directory dell'host non disponibili al processo Caddy.

pacman -Syu caddy

Visualizza Caddy nei repository di Arch Linux e il Wiki di Arch Linux

Docker

docker pull caddy

Visualizza su Docker Hub

Consultate la nostra configurazione Docker Compose raccomandata e le istruzioni d'uso.

Railway

Grazie alla sponsorizzazione di Railway, supportiamo ufficialmente questo template:

Deploy on Railway

Gentoo

Nota: Questo è un metodo di installazione gestito dalla comunità.

emerge www-servers/caddy

Visualizza il pacchetto Gentoo

Homebrew (Mac)

Nota: Questo è un metodo di installazione gestito dalla comunità.

brew install caddy

Visualizza la formula Homebrew

Chocolatey (Windows)

Nota: Questo è un metodo di installazione gestito dalla comunità.

choco install caddy

Visualizza il pacchetto Chocolatey

Scoop (Windows)

Nota: Questo è un metodo di installazione gestito dalla comunità.

scoop install caddy

Visualizza il manifest di Scoop

Webi

Nota: Questo è un metodo di installazione gestito dalla comunità.

Linux e macOS:

curl -sS https://webi.sh/caddy | sh

Windows:

curl.exe https://webi.ms/caddy | powershell

Potrebbe essere necessario regolare le regole del firewall di Windows per consentire connessioni in entrata non provenienti da localhost.

Visualizza su Webi

Ansible

Nota: Questo è un metodo di installazione gestito dalla comunità.

ansible-galaxy install nvjacobo.caddy

Visualizza il repository del ruolo Ansible

Termux

Nota: Questo è un metodo di installazione gestito dalla comunità.

pkg install caddy

Visualizza il file build.sh di Termux

Nix/Nixpkgs/NixOS

Nota: Questo è un metodo di installazione gestito dalla comunità.

Visualizza Caddy nella ricerca Nixpkgs e nella ricerca delle opzioni NixOS

Unikraft

Nota: Questo è un metodo di installazione gestito dalla comunità.

Per prima cosa installate lo strumento complementare di Unikraft, kraft:

curl --proto '=https' --tlsv1.2 -sSf https://get.kraftkit.sh | sh

Quindi eseguite Caddy con Unikraft usando:

kraft run --rm -p 2015:2015 --plat qemu --arch x86_64 -M 256M caddy:2.7

Per consentire connessioni in entrata non provenienti da localhost, è necessario connettere l'istanza unikernel a una rete.

Visualizza il catalogo delle applicazioni Unikraft e gli esempi della piattaforma KraftCloud (basata su Unikraft).

OPNsense

Nota: Questo è un metodo di installazione gestito dalla comunità.

pkg install os-caddy

Visualizza il makefile caddy-custom di FreeBSD e il sorgente del plugin os-caddy

Mise

Nota: Questo è un metodo di installazione gestito dalla comunità.

Se state usando mise, il gestore di versioni di strumenti poliglotta, potete usare un comando come questo per installare l'ultima versione:

mise use -g caddy@latest