Coolify è un'alternativa open source e self-hosted a Heroku e Vercel, che ti permette di gestire facilmente server, applicazioni e database.
La dashboard intuitiva di Coolify rende il self-hosting un gioco da ragazzi. Hai il pieno controllo della tua infrastruttura, puoi automatizzare i deployment da GitHub e mantenere bassi i costi del cloud.
In questa guida ti mostreremo passo dopo passo come configurare Coolify, predisporre il tuo account amministratore e impostare tutto ciò che devi sapere.
Coolify è leggero, ma il consumo di risorse può aumentare notevolmente in base al numero di app distribuite, alle build Docker e ai database in esecuzione. Per usare Coolify sul tuo VPS/server dedicato, consigliamo i seguenti requisiti hardware:
| Hardware | Minimo | Consigliato |
|---|---|---|
| CPU | 2 core vCPU | 4 core vCPU |
| RAM | 2 GB | 4 GB+ |
| Spazio su disco | 30 GB | 50 GB+ |
Prima di installare Coolify, collegati al tuo server e assicurati che il sistema operativo sia aggiornato. Devi connetterti tramite SSH con accesso root. Se hai bisogno di aiuto, consulta la nostra guida al primo accesso SSH.
Autenticazione con chiave SSH
Consigliamo vivamente di configurare l'autenticazione con chiave SSH anziché usare una password. Scopri come fare nella nostra guida alla configurazione della chiave SSH.
Dopo esserti collegato al server, aggiorna i pacchetti di sistema e installa curl, necessario per scaricare lo script di installazione di Coolify:
sudo apt update && sudo apt upgrade -y && sudo apt install curl -y
Coolify applica regole di sicurezza rigorose all'account amministratore. Prima di avviare lo script di installazione, prepara le credenziali dell'utente root in base ai seguenti requisiti:
- Nome utente
- Almeno 3 caratteri
- Massimo 255 caratteri
- Sono consentiti solo lettere, numeri, spazi, trattini bassi e trattini
- E-mail
- Deve essere un indirizzo e-mail valido
- Deve avere una voce DNS valida
- Massimo 255 caratteri
- Password
- Almeno 8 caratteri
- Deve contenere lettere maiuscole e minuscole
- Almeno un numero
- Almeno un carattere speciale
- Non deve essere una password comune o compromessa
Coolify offre uno script di installazione rapido e automatizzato. Per proteggere l'installazione, impostiamo in anticipo i dati dell'amministratore root tramite variabili d'ambiente. In questo modo si impediscono accessi non autorizzati durante la configurazione.
Esegui il comando seguente e sostituisci nome utente, e-mail e password con le tue credenziali sicure:
env ROOT_USERNAME=zaphosting ROOT_USER_EMAIL=info@zap-hosting.com ROOT_USER_PASSWORD=zaphosting bash -c 'curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash'
Open source
Puoi trovare il codice sorgente dello script di installazione nel repository ufficiale di Coolify
Lo script installa automaticamente Docker, configura le reti necessarie e imposta i container Coolify. L'operazione può richiedere alcuni minuti, a seconda dell'hardware del server.
Al termine dell'installazione, puoi aprire la dashboard nel browser. Inserisci l'indirizzo IP del server e la porta 8000: http://[deine_server_ip]:8000
Poiché hai già inserito le credenziali nel comando di installazione, accederai direttamente alla schermata di login e non alla procedura guidata di configurazione.
Accedi usando l'indirizzo e-mail e la password che hai inserito nel terminale.
Dopo aver effettuato l'accesso, ti consigliamo di configurare subito un dominio personalizzato. L'accesso tramite indirizzo IP (http://[deine_server_ip]:8000) non è sicuro.
Con un dominio, Coolify può creare automaticamente certificati SSL gratuiti per la dashboard e tutte le applicazioni future.
Vai alla gestione DNS del tuo provider di domini e aggiungi due nuovi record A che puntino al tuo server. Se il tuo dominio è registrato presso ZAP-Hosting, consulta la nostra guida alla configurazione dei record di dominio:
| Nome / Host | Tipo | Valore | TTL |
|---|---|---|---|
@ | A | [deine_server_ip] | Automatico / Basso |
* | A | [deine_server_ip] | Automatico / Basso |
Routing DNS
- Il record
@consente a Coolify di usare il dominio principale - Il record wildcard
*fa sì che Coolify instradi automaticamente tutti i nuovi sottodomini (ad esempioapi.[deine_domain]), senza che tu debba creare record DNS per ogni progetto.
Per proteggere la tua istanza Coolify con un certificato SSL, ti consigliamo di assegnarle un dominio. Nel menu a sinistra, vai su Impostazioni e trova il campo Instance Domain. Inserisci il tuo dominio, incluso https:// (ad esempio https://coolify.[deine_domain]). Salva la modifica.
