Come installare Cloudron su VPS Ubuntu: guida pratica
Segui i passaggi per installare Cloudron su una VPS pulita. Configura il record DNS wildcard, esegui lo script di setup e gestisci certificati, backup e posta per le tue app.
Installare Cloudron su una VPS: versione breve
Per installare Cloudron su una VPS è necessario un server Ubuntu pulito, almeno 2 GB di RAM e un dominio di cui sia possibile modificare i record DNS. L'installazione consiste in tre comandi e un riavvio. Quasi tutti i problemi si verificano prima di questo passaggio (immagine di base errata, tipo di virtualizzazione non supportato) o dopo (DNS, posta, backup).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron installa, aggiorna, esegue il backup ed emette certificati TLS (transport layer security) per le applicazioni self-hosted. Ogni applicazione viene eseguita in Docker, nginx si posiziona davanti a tutte e ogni applicazione riceve un proprio sottodominio del tuo dominio. Quest'ultimo dettaglio è il motivo per cui la configurazione DNS deve essere eseguita per prima.
Perché Cloudron richiede un sistema operativo di base specifico
Lo script di configurazione controlla il server prima di installare qualsiasi componente. Se un controllo fallisce, devi ordinare un nuovo server. Leggi questi requisiti prima di scegliere un'immagine. I controlli dell'installer riportati in questa sezione risalgono al 13 ottobre 2026; la documentazione di installazione attuale richiede un server Ubuntu 26.04 appena installato.
- Solo Ubuntu, e solo tre release. Qualsiasi altra versione termina con
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 viene rifiutato e la documentazione di installazione ora richiede un server Ubuntu 26.04 appena installato. Debian, Rocky e Alpine non sono supportati. Ubuntu 24.04 richiede Cloudron 8 o versioni successive; lo script verifica automaticamente questo requisito. - Solo Intel o AMD a 64 bit:
Error: Cloudron only supports amd64/x86_64. Un VPS ARM non può eseguirlo. - Solo virtualizzazione hardware completa. Su un VPS basato su container lo script si interrompe con
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualizationperché rileva il container tramitesystemd-detect-virt --container. KVM è supportato. OpenVZ e LXC non lo sono. - Il filesystem root deve essere
ext4oxfs. In caso contrario viene restituitoError: Cloudron requires '/' to be ext4 or xfs. È così che falliscono le immagini btrfs e zfs. - Almeno 941 MB di RAM, misurati con
free -m, e 18 GB su/, misurati come dimensione del filesystem root. Il messaggio di errore richiede 20GB, ma il controllo passa con un filesystem root da 19 GB. - Un server realmente appena installato. Se
nginx,dockeronodeè già installato, lo script rifiuta l'installazione conError: Some packages like nginx/docker/nodejs are already installed.
Quest'ultimo controllo è quello che genera più discussioni. Il motivo è il seguente. Cloudron installa versioni bloccate di Docker, nginx, Node.js e MySQL, scrive la configurazione nginx per ogni applicazione che ospita e gestisce direttamente le regole del firewall iptables. Un'installazione di Docker eseguita il giorno precedente potrebbe avere una versione incompatibile. Per questo lo script termina senza modificare nulla e chiede di partire da un'installazione Ubuntu appena effettuata. Cloudron gestisce l'intera macchina, quindi assegnagli un VPS dedicato.
È facile non notare un altro controllo. Su una CPU meno recente senza AVX (advanced vector extensions), lo script stampa CPU has no AVX support. MongoDB will be disabled e tutte le applicazioni che richiedono MongoDB diventano non installabili. Controlla la CPU prima di procedere con grep -m1 -o avx /proc/cpuinfo: su un host compatibile stampa avx, mentre su uno meno recente non stampa nulla.
Quanta RAM richiede Cloudron?
Il controllo dell'installer del 13 ottobre 2026 rifiutava di avviarsi con meno di 941 MB, con Error: Cloudron requires atleast 1GB physical memory; la documentazione attuale richiede 2 GB di RAM e 20 GB di spazio su disco. Entrambi i valori sono il minimo per la piattaforma, non per la piattaforma insieme alle applicazioni. Cloudron esegue Docker, nginx, il proprio servizio box e lo stack di posta, oltre a predisporre servizi di database condivisi quando vengono distribuite le applicazioni. Eseguire docker ps su un'installazione pulita e contarli.
I limiti di memoria delle applicazioni si aggiungono a questa base. Ogni pacchetto applicativo viene fornito con un limite predefinito ridotto, che si può aumentare tramite il cursore nella vista Resources dell'applicazione. Quando un'applicazione supera il proprio limite, viene riavviata e invia una notifica OOM (out of memory); quindi, se un server continua a riavviare una determinata applicazione, di solito il problema è il limite e non un bug.
Queste sono le dimensioni che sceglierei. Sono consigli per un server che non dovrete ricostruire il mese prossimo. Non sono risultati di benchmark misurati.
I dati alla base di questo grafico
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Due applicazioni funzionano senza problemi con 4 GB di RAM e 60 GB di spazio su disco. Circa dieci applicazioni richiedono 16 GB e 240 GB, perché la base della piattaforma non si riduce mai e ogni applicazione aggiunge un'immagine Docker, un database e i propri dati. Il disco si riempie più velocemente del previsto: immagini, dati delle applicazioni e backup locali condividono lo stesso volume finché non si spostano i backup fuori dal server.
Cloudron assegna a ogni applicazione uno swap senza limiti, quindi il limite di memoria configurato si applica soltanto alla RAM. Su un'immagine VPS senza file di swap, swapon --show non stampa nulla e la pressione sulla memoria causa direttamente riavvii OOM anziché rallentare l'applicazione. Aggiungere 2 GB di swap è una misura preventiva economica, ma non sostituisce la memoria reale. La differenza tra i piani VPS è ridotta rispetto alle ore necessarie per ottimizzare i limiti; consultate quindi quanto costa realmente un VPS e scegliete il piano di dimensioni immediatamente superiori.
DNS: il record wildcard che abilita i sottodomini delle app
Cloudron pubblica il dashboard su my.example.com e ogni app sul proprio sottodominio, quindi il DNS è un prerequisito, non un'attività da svolgere in seguito. Prima di aprire il dashboard per la prima volta, punta questi record all'indirizzo IP pubblico del server:
my.example.comcome record A. Questo è il dashboard.*.example.comcome record A. È il record che abilita i sottodomini delle app, quindiwiki.example.comegit.example.comrisolveranno non appena installerai queste app.example.comcome record A, solo se vuoi pubblicare un'app sul dominio nudo.
Un record wildcard ha una precedenza inferiore rispetto a un record esplicito, quindi un record www.example.com esistente che punta altrove continuerà a funzionare.
Durante la configurazione scegli come Cloudron gestirà il DNS da quel momento in poi:
- Un provider API. Cloudron memorizza un token per Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS e altri provider (22 integrazioni API DNS in totale, esclusi Wildcard, Manual e No-op), quindi crea autonomamente ogni record, inclusi i record di posta.
- Wildcard. Aggiungi manualmente il record
*e Cloudron non crea alcun record. - Manual. Cloudron mostra ogni record e attende che tu lo aggiunga, prima di ogni singola installazione di un'app.
Un record DNS wildcard non è un certificato wildcard. Il provider di certificati predefinito è Let's Encrypt Prod - Wildcard, che dimostra il controllo del dominio tramite DNS, quindi funziona soltanto con un provider API. Con i backend Wildcard o Manual, Let's Encrypt emette certificati individuali con validazione tramite HTTP, che richiede la porta 80 in ingresso per l'emissione e il rinnovo. Puoi invece disabilitare l'integrazione con Let's Encrypt e caricare un certificato wildcard personalizzato, così la porta 80 non è un requisito permanente per la validazione del certificato. Se il tuo registrar o host DNS è presente nell'elenco API, usalo: i record di posta e i certificati non saranno più a tuo carico.
Verifica prima di procedere. dig +short my.example.com e dig +short anything.example.com dovrebbero entrambi restituire l'indirizzo IP del server. Con il backend Wildcard, se la query wildcard non restituisce nulla, in seguito le app non funzioneranno, mentre il dashboard continuerà a funzionare.
Se il dominio si trova dietro Cloudflare, imposta i record come DNS only. Il proxy inoltra soltanto HTTP e HTTPS, quindi le porte di posta non funzionano. Per le app web che passano dal proxy, la vista Network di Cloudron consente di considerare attendibili gli intervalli IP pubblicati da Cloudflare, così da recuperare l'indirizzo del visitatore dagli header inoltrati.
Esegui lo script di configurazione
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupEseguilo come root oppure tramite sudo, perché altrimenti la prima riga visualizzata è This script should be run as root.. L'installazione richiede diversi minuti e non mostra output durante l'esecuzione, perché l'output di apt e i pull delle immagini Docker vengono scritti in un file di log. Monitoralo da una seconda sessione SSH:
tail -f /var/log/cloudron-setup.logNel controllo dell'installer del 13 ottobre 2026, lo script ha visualizzato After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. seguito dall'indirizzo del server, quindi ha chiesto The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Rispondi yes. Quell'installer forniva anche il flag --skip-reboot per rimandare il riavvio.
Primo avvio: dominio, backend DNS e account amministratore
Apri https://<server-ip> e accetta l'avviso del browser. Il certificato è autofirmato perché Cloudron non conosce ancora il tuo dominio, quindi non ha un nome da comunicare a una certification authority per richiedere un certificato. In Chrome fai clic su Advanced, quindi su Proceed to <ip> (unsafe). In Firefox fai clic su Advanced, quindi su Accept the Risk and Continue.
La prima schermata richiede il dominio. Inserisci example.com e il dashboard passa a my.example.com. In alternativa, puoi usare un sottodominio come cloudron.example.com; in questo caso il dashboard sarà disponibile su my.cloudron.example.com. Seleziona il backend DNS, incolla il token API se ne hai uno e crea l'account amministratore usando un indirizzo email che controlli realmente: per i reset della password e le notifiche della piattaforma verrà usato questo indirizzo.
Quando salvi, Cloudron richiede i certificati e sposta il dashboard su https://my.example.com. Da quel momento l'URL con l'indirizzo IP non funziona più, quindi aggiungi ai segnalibri il nuovo URL.
Certificati: cosa esegue il rinnovo e quando si interrompe
Il rinnovo del certificato è automatico e segue ACME Renewal Information (ARI), cioè la pianificazione pubblicata dall'autorità di certificazione, che in pratica esegue il rinnovo circa un mese prima della scadenza. In caso di rinnovo non riuscito, un'email viene inviata all'account amministrativo e, dopo la scadenza del certificato, viene usato il certificato autofirmato integrato. È questo fallback a causare l'avviso del browser su un sito che il giorno precedente funzionava.
Nella maggior parte dei casi il problema dipende da una di due cause. La convalida HTTP richiede la porta in ingresso 80. Chiudere la porta 80 perché "tanto è tutto HTTPS" interrompe il rinnovo per le applicazioni che usano la convalida HTTP di Let's Encrypt con un backend Wildcard o Manual DNS. La convalida DNS richiede un token API che disponga ancora dell'accesso in scrittura. La rotazione o la limitazione di questo token interrompe il rinnovo senza messaggi immediati, fino all'arrivo dell'email di avviso.
La vista Domains contiene un pulsante Renew All per forzare subito il tentativo e un provider Let's Encrypt Staging per i test. I certificati Staging non sono considerati attendibili dai browser intenzionalmente. Questo consente di eseguire i test senza consumare i limiti di frequenza dell'ambiente di produzione. Staging ha limiti propri, tra cui 200 errori di autorizzazione per identificatore, per account, ogni ora.
Utilizzare il server di posta integrato?
Cloudron include uno stack completo per la posta, con caselle IMAP, invio tramite submission, filtri Sieve e firma DKIM (DomainKeys Identified Mail). Lo si abilita per ogni dominio nella sezione Email della dashboard. Il problema più complesso è ottenere la consegna dei messaggi, e nessuna delle difficoltà dipende da Cloudron.
- La porta in uscita 25 è bloccata dalla maggior parte dei provider VPS per limitare lo spam. Alcuni provider la sbloccano dopo una richiesta al supporto. Eseguire il test dal server con
nc -zv aspmx.l.google.com 25(installarenetcat-openbsdse il comando non è disponibile). Le porte aperte restituisconosucceeded; una porta bloccata resta in attesa fino al timeout. - Il record PTR (DNS inverso) viene impostato dal provider VPS, non dal gestore DNS, e deve corrispondere al nome host della posta quando si inviano i messaggi direttamente dal server. Un relay SMTP elimina questo requisito relativo al record PTR.
- I record SPF, DKIM e DMARC vengono creati automaticamente su un backend DNS con API. Con i backend Wildcard o Manual è necessario aggiungerli manualmente; se manca il record DKIM, ogni messaggio firmato risulta non verificabile.
Per la maggior parte degli utenti, la configurazione più funzionale consiste nel ricevere la posta su Cloudron e inviarla tramite un relay come SendGrid, Postmark, Mailgun o Amazon SES, configurato nella vista Email. Il relay deve consentire l'invio usando qualsiasi indirizzo del dominio; in caso contrario, le notifiche delle applicazioni con mittenti diversi vengono rifiutate. Se la posta è il motivo principale per cui si acquista il server, eseguire un server di posta dedicato, ad esempio Mailcow su un sistema separato con un proprio indirizzo IP e una propria reputazione.
Se non si utilizza affatto Cloudron Email, bloccare le porte 25, 465, 587, 993 e 4190 nel firewall del provider. Eseguire questa operazione sul provider, non sul server, perché Cloudron scrive autonomamente le regole iptables e ne presuppone il controllo. È l'opposto di un VPS semplice, in cui si gestiscono autonomamente le regole ufw.
Configurare la destinazione di backup prima che sia necessario
I backup vengono salvati per impostazione predefinita sul filesystem locale in /var/backups, sullo stesso disco di tutto il resto. La documentazione è chiara al riguardo: "Avere i backup residenti sullo stesso disco fisico del server della piattaforma è pericoloso". Un singolo guasto al disco distrugge sia le applicazioni che i backup.
Apri Backups, poi Backup Sites, e punta la destinazione altrove fin dal primo giorno. Lo storage a oggetti compatibile con S3 è la soluzione standard (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces o un bucket MinIO su un secondo server), ma sono supportati anche SSHFS, NFS, CIFS e destinazioni su filesystem semplice.
Tre impostazioni determinano se il backup è affidabile:
- Formato.
tgzscrive un archivio compresso per ogni applicazione e ricarica l'intero contenuto a ogni esecuzione.rsynccarica solo i file modificati, il che è molto più economico per una grande istanza Nextcloud, al costo di un numero maggiore di richieste verso l'API di storage. - Cifratura. AES-256 opzionale che copre sia il contenuto dei file che i nomi dei file. Cloudron non conserva una copia della password, quindi perderla significa che i backup non potranno essere decifrati da nessuno, nemmeno da te. Salvala in un password manager self-hosted prima di fare clic su salva.
- Conservazione. Definita tramite conteggi come 7 giornalieri e 4 settimanali. Una conservazione prolungata sullo storage a oggetti comporta costi mensili, quindi scegli un numero che sei disposto a mantenere nel tempo.
Successivamente, esegui un test di ripristino. Installa una piccola applicazione, ripristinala dalla dashboard e verifica che i dati siano tornati correttamente. Un backup che non è mai stato ripristinato è solo una supposizione.
Limiti del piano gratuito
A ottobre 2026 il piano gratuito è limitato a due applicazioni installate. Include tutto il resto: aggiornamenti delle applicazioni, backup per singola applicazione, firewall, server di posta e single sign-on. La terza applicazione è il punto in cui serve una licenza. I piani a pagamento rimuovono il limite al numero di applicazioni; il piano superiore aggiunge gruppi e ruoli utente, un server di directory e più sedi di backup. I prezzi cambiano, quindi consulta la pagina dei prezzi di Cloudron invece di usare un importo riportato in un tutorial.
Una licenza copre una singola installazione di Cloudron, quindi due server piccoli costano il doppio rispetto a un server più grande. Questo modello di prezzo porta la maggior parte degli utenti a scegliere un unico VPS più grande, in contrasto con la raccomandazione usuale di distribuire i servizi su più macchine. Dimensiona il server tenendo conto di questo aspetto, perché dividere i servizi in seguito significa pagare due volte.
Quando qualcosa non funziona
Inizia con il controllo integrato. Verifica in sequenza DNS, certificati, disco, memoria e ogni servizio, quindi indica quale test non è riuscito:
sudo cloudron-support --troubleshootSuccessivamente, usa i normali strumenti systemd (gestore del sistema e dei servizi). systemctl status box restituisce lo stato del servizio Cloudron, journalctl -u box -n 100 mostra i log recenti e journalctl -u docker fornisce informazioni sul runtime dei container sottostante. Tutto ciò che non ha funzionato durante l'installazione viene registrato in /var/log/cloudron-setup.log.
Se una dashboard non si carica, la causa è generalmente il DNS o il firewall del provider, non Cloudron. Esegui dig +short my.example.com dal laptop e verifica che le porte 80 e 443 siano aperte nel firewall di rete del provider, che è un controllo distinto dalle regole del server. Nel controllo dell'installer del 13 ottobre 2026, una seconda esecuzione è stata rifiutata con Error: Cloudron is already installed. To reinstall, start afresh; la soluzione corretta consiste nel ricreare il server.
Quando Cloudron non è la soluzione adatta
Cloudron è indicato quando si desidera gestire applicazioni e non infrastruttura. È una scelta poco adatta se si intende eseguire i propri container in modo personalizzato, poiché il sistema gestisce autonomamente nginx, Docker e il firewall, sovrascrivendo qualsiasi modifica manuale. Se il proprio obiettivo è utilizzare una cartella di file compose, Traefik davanti ai propri stack Docker Compose offre la stessa gestione automatica di TLS e routing dei sottodomini senza dover installare una piattaforma sovrastante. Se non è stata ancora presa una decisione, Confronto tra Cloudron, CasaOS e Coolify mette a confronto queste soluzioni, mentre l'elenco completo delle applicazioni self-hosted rappresenta un punto di partenza migliore rispetto a una guida all'installazione.
FAQ
Quanta RAM richiede Cloudron su un VPS?
Il controllo dell’installer del 13 ottobre 2026 rifiutava l’esecuzione con meno di 941 MB; la documentazione attuale richiede 2 GB, ma questo è il limite minimo per la piattaforma senza applicazioni installate. Cloudron esegue Docker, nginx, il proprio servizio box e lo stack di posta, oltre a predisporre servizi di database condivisi quando vengono distribuite le applicazioni. Prevedere 4 GB per due applicazioni e 16 GB per circa dieci, e aggiungere un file di swap, perché Cloudron assegna alle applicazioni una quantità di swap illimitata e un sistema che ne è privo trasforma la pressione sulla memoria in riavvii.
Posso installare Cloudron su Debian o su un server che esegue già Docker?
Nessuna delle due configurazioni è supportata. Nel controllo dell’installer del 13 ottobre 2026, lo script si arrestava in presenza di release non supportate con Cloudron requires Ubuntu 22.04, 24.04, 26.04 e rifiutava i server sui quali erano già presenti nginx, docker o node. La documentazione di installazione attuale richiede un’immagine Ubuntu pulita ed esclude Debian, Rocky e Alpine. Partire da un’immagine Ubuntu pulita su un VPS KVM.
Perché i sottodomini delle applicazioni non funzionano mentre il dashboard è accessibile?
Sul backend Wildcard, controllare il record DNS wildcard. La configurazione crea o richiede un record A per my.example.com, quindi il dashboard viene risolto, mentre wiki.example.com restituisce NXDOMAIN e il browser segnala che il sito non è disponibile. Aggiungere un record A per *.example.com che punti all’indirizzo IP del server, quindi verificare con dig +short wiki.example.com prima di installare l’applicazione.
Devo usare il server di posta Cloudron?
No. È possibile disabilitare la posta in arrivo e inviare i messaggi tramite un relay esterno come Postmark, Mailgun o Amazon SES. Questa è la scelta più sicura quando il provider blocca il traffico in uscita sulla porta 25 o l’indirizzo IP non ha una reputazione adeguata per la posta. Se si ignora completamente Cloudron Email, chiudere le porte 25, 465, 587, 993 e 4190 nel firewall del provider, non sul server.
Cosa succede quando raggiungo il limite di due applicazioni del piano gratuito?
Per installare una terza applicazione è necessario un abbonamento a pagamento. Le applicazioni già in esecuzione non vengono modificate: continuano a ricevere gli aggiornamenti, a essere sottoposte a backup e a mantenere i propri certificati. Aggiungere un abbonamento rimuove il limite senza reinstallare nulla; il piano gratuito è quindi un modo valido per testare prima la piattaforma su un dominio reale.