Configurare GitLab su un VPS

GitLab è una piattaforma DevOps completa — hosting di repository Git, pipeline CI/CD, gestione delle attività e collaborazione del team, tutto in un unico strumento. Gestire la propria istanza su un VPS significa avere il controllo totale: il codice rimane sul tuo server, nessun limite sui repository privati e nessuna terza parte ha accesso ai tuoi dati. Per i team che lavorano su codebase sensibili o progetti interni, è una differenza significativa rispetto all'affidarsi a un'istanza cloud condivisa.

GitLab è progettato per consumare molte risorse. Prima di iniziare, assicurati che il tuo VPS abbia almeno 4 GB di RAM e 4 core CPU — con meno è probabile che tu incontri problemi di stabilità.

• Sito ufficiale
• Documentazione di GitLab

Configurare il dominio

GitLab ha bisogno di un dominio per ottenere automaticamente un certificato SSL tramite Let's Encrypt. Senza di esso, la configurazione non andrà a buon fine.

1. Registra un dominio o crea un sottodominio — qualcosa come git.tuo-sito.com va benissimo.
2. Vai alla sezione di gestione DNS nel tuo pannello di controllo e crea un record A che punta all'indirizzo IP del tuo VPS.
3. Attendi la propagazione DNS — di solito richiede dai 5 ai 30 minuti.

Connettersi al server

1. Accedi al tuo pannello di controllo → VPS → seleziona il tuo server.
2. Recupera l'indirizzo IP e la password di root dai dettagli dell'ordine.
3. Connettiti tramite SSH specificando subito la porta 2222:

ssh root@IP_DEL_TUO_SERVER -p 2222

Connessione al server e configurazione iniziale di GitLab

Avviare la procedura guidata di configurazione

Al primo accesso verrai accolto dalla schermata di benvenuto di GitLab Direct Image:

*****************************************************
* GitLab Direct Image (SSL / Port 22 for Git)       *
*****************************************************
* EN: BEFORE RUNNING: Point A-record to this server IP
* EN: SYSTEM SSH PORT: 2222
* EN: To start setup, run: gitlab-setup
*****************************************************

La procedura guidata ti porrà due domande:

1. Domain — inserisci il tuo dominio (es. git.example.com):

Enter your domain (e.g., git.example.com):

2. Email — inserisci un indirizzo per le notifiche SSL di Let's Encrypt:

Enter Email for SSL notifications:

Dopodiché lo script prende il controllo e avvia GitLab tramite Docker Compose. Vedrai un output simile a questo:

🐳 Starting GitLab via docker compose...
[+] up 2/2
 ✔ Network gitlab_default  Created   0.0s
 ✔ Container gitlab-web    Started   0.5s
------------------------------------------------
✅ Setup initiated!
⚠️  WARNING: System SSH is now on port 2222!
⏳ GitLab will be ready in 3-5 minutes.
🔑 Initial root password will be available at:
   cat /root/gitlab/config/initial_root_password
------------------------------------------------

Configurazione di GitLab in corso

Ottenere la password amministratore

GitLab genera automaticamente una password temporanea per l'account root. Recuperala con il comando:

cat /root/gitlab/config/initial_root_password

Copia la password (il lungo codice alfanumerico dopo la parola Password:) in un posto sicuro — ti servirà tra poco.

Recupero della password root iniziale di GitLab

Primo accesso

Dai a GitLab 3–5 minuti per avviarsi completamente, poi apri il browser e vai su:

https://tuo-dominio.com

Schermata di accesso di GitLab

Accedi con:

• Username: root
• Password: quella recuperata nel passaggio precedente

Una volta effettuato l'accesso, vai subito in User Settings → Password e imposta una password permanente prima di fare qualsiasi altra cosa.

Modifica della password in GitLab

Gestire il servizio

GitLab gira in Docker, quindi si applicano i normali comandi di docker compose. Prima spostati nella directory del progetto:

cd /root/gitlab

Poi usa il comando di cui hai bisogno:

• Riavvio: docker compose restart
• Stop: docker compose down
• Avvio: docker compose up -d
• Seguire i log: docker compose logs -f

Cose utili da sapere

• Separazione delle porte SSH: la porta 22 è riservata esclusivamente alle operazioni Git (git clone, git push, ecc.). Per connetterti al server tramite SSH, usa sempre la porta 2222.
• Riavvio automatico: il container Docker è configurato per avviarsi automaticamente al riavvio del server — la tua istanza GitLab tornerà operativa senza alcun intervento manuale.
• Risorse: tieni d'occhio l'utilizzo della memoria, soprattutto man mano che il team e i repository crescono. Puoi monitorare il carico del server dalla dashboard e passare a un piano superiore se necessario.
• Backup: prenditi l'abitudine di fare backup regolari dei tuoi repository e delle configurazioni. Lo strumento di backup integrato: docker exec -t gitlab-web gitlab-rake gitlab:backup:create.
  Il backup viene generato all'interno del container Docker in /var/opt/gitlab/backups/. Per copiare il file nella directory corrente dell'host, esegui:

docker cp gitlab-web:/var/opt/gitlab/backups/<backup_filename>.tar .