Cum instalezi și configurezi Gitea pe un VPS Linux: ghid complet pentru un server Git propriu

Dacă lucrezi cu cod sursă și vrei control total asupra repository-urilor tale, Gitea este una dintre cele mai bune soluții open-source disponibile astăzi. Ușor de instalat, rapid și cu o interfață modernă similară cu GitHub, Gitea poate rula excelent pe un VPS SSD chiar și cu resurse modeste.

În acest ghid vei învăța cum să instalezi Gitea pe un server Ubuntu 22.04, să îl configurezi în spatele unui reverse proxy Nginx și să îl securizezi cu un certificat SSL — totul pas cu pas.

Ce este Gitea și de ce să îl folosești?

Gitea este o platformă Git self-hosted scrisă în Go. Oferă:

Repository-uri Git cu interfață web modernă
Issues, Pull Requests, Wiki — funcționalități similare GitHub
Autentificare cu 2FA, OAuth2, LDAP
Webhook-uri pentru integrarea cu CI/CD
Consum redus de resurse — funcționează pe servere cu 1 GB RAM

Spre deosebire de GitLab, care necesită resurse semnificative, Gitea este ideal dacă alegi un VPS NVMe de intrare sau unul cu specificații medii.

Cerințe preliminare

Înainte de a începe, asigură-te că ai:

Un VPS cu Ubuntu 22.04 (minim 1 vCPU, 1 GB RAM)
Acces root sau sudo
Un domeniu configurat (ex: git.exemplu.md) cu DNS-ul îndreptat spre IP-ul VPS-ului
Nginx instalat (îl vom instala dacă nu există)

Dacă nu ai încă un server, poți alege un VPS 1C de la CLIQHOST, potrivit exact pentru acest tip de aplicații.

Pasul 1: Actualizează sistemul și instalează dependențele

Începe prin actualizarea pachetelor:

sudo apt update && sudo apt upgrade -y

Instalează Git și alte dependențe necesare:

sudo apt install -y git wget curl nginx

Pasul 2: Creează utilizatorul dedicat pentru Gitea

Pentru securitate, Gitea trebuie să ruleze sub un utilizator fără privilegii root:

sudo adduser \
  --system \
  --shell /bin/bash \
  --gecos 'Gitea' \
  --group \
  --disabled-password \
  --home /home/gitea \
  gitea

Pasul 3: Creează structura de directoare

sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R gitea:gitea /var/lib/gitea/
sudo chmod -R 750 /var/lib/gitea/

sudo mkdir /etc/gitea
sudo chown root:gitea /etc/gitea
sudo chmod 770 /etc/gitea

Pasul 4: Descarcă și instalează Gitea

Verifică pagina oficială Gitea pentru ultima versiune stabilă, apoi descarcă binarul:

wget -O /tmp/gitea https://dl.gitea.com/gitea/1.22.0/gitea-1.22.0-linux-amd64

Mutați binarul și setați permisiunile:

sudo mv /tmp/gitea /usr/local/bin/gitea
sudo chmod 755 /usr/local/bin/gitea

Verifică instalarea:

gitea --version

Pasul 5: Configurează baza de date (SQLite sau MySQL)

Opțiunea A: SQLite (recomandat pentru proiecte mici)

Gitea include suport nativ pentru SQLite — nu este nevoie de instalare suplimentară. Aceasta este opțiunea cea mai simplă.

Opțiunea B: MySQL/MariaDB (recomandat pentru producție)

sudo apt install -y mariadb-server
sudo mysql_secure_installation

Creează baza de date și utilizatorul Gitea:

sudo mysql -u root -p

CREATE DATABASE gitea CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'gitea'@'localhost' IDENTIFIED BY 'parola_secreta';
GRANT ALL PRIVILEGES ON gitea.* TO 'gitea'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Pasul 6: Creează serviciul systemd

Pentru ca Gitea să pornească automat, creează un fișier de serviciu:

sudo nano /etc/systemd/system/gitea.service

Conținutul fișierului:

[Unit]
Description=Gitea (Git with a cup of tea)
After=network.target
After=mariadb.service

[Service]
RestartSec=2s
Type=simple
User=gitea
Group=gitea
WorkingDirectory=/var/lib/gitea/
ExecStart=/usr/local/bin/gitea web --config /etc/gitea/app.ini
Restart=always
Environment=USER=gitea HOME=/home/gitea GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

Activează și pornește serviciul:

sudo systemctl daemon-reload
sudo systemctl enable gitea
sudo systemctl start gitea

Verifică starea:

sudo systemctl status gitea

Gitea rulează acum pe portul 3000 (implicit).

Pasul 7: Configurează Nginx ca reverse proxy

Creează un virtual host Nginx pentru domeniul tău:

sudo nano /etc/nginx/sites-available/gitea

server {
    listen 80;
    server_name git.exemplu.md;

    location / {
        proxy_pass http://localhost:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Activează configurația:

sudo ln -s /etc/nginx/sites-available/gitea /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

Pasul 8: Instalează certificatul SSL cu Let's Encrypt

Instalează Certbot:

sudo apt install -y certbot python3-certbot-nginx

Obtine certificatul:

sudo certbot --nginx -d git.exemplu.md

Certbot va modifica automat configurația Nginx pentru HTTPS. Dacă preferi un certificat comercial cu validare extinsă, aruncă o privire la certificatele SSL CLIQHOST disponibile pentru diferite nevoi.

Pasul 9: Configurarea inițială prin interfața web

Accesează https://git.exemplu.md în browser. Vei vedea pagina de instalare Gitea.

Setări esențiale:

Câmp	Valoare recomandată
Database Type	SQLite3 sau MySQL
Site Title	Numele tău
Repository Root Path	`/var/lib/gitea/data/repositories`
Git Hooks Path	`/var/lib/gitea/data/home`
HTTP Port	3000
Application URL	`https://git.exemplu.md`

Creează contul de administrator și finalizează instalarea.

Pasul 10: Configurare avansată prin app.ini

După instalare, fișierul de configurare se află la /etc/gitea/app.ini. Câteva setări utile:

Dezactivează înregistrările publice

[service]
DISABLE_REGISTRATION = true

Configurează emailul (SMTP)

[mailer]
ENABLED = true
FROM = [email protected]
SMTP_ADDR = smtp.exemplu.md
SMTP_PORT = 587
USER = [email protected]
PASSWD = parola_smtp

Limitează dimensiunea repository-urilor

[repository]
MAX_CREATION_LIMIT = -1
DEFAULT_PUSH_CREATE_PRIVATE = true

După orice modificare, repornește serviciul:

sudo systemctl restart gitea

Pasul 11: Securizarea instalației Gitea

Configurează firewall-ul

sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status

Activează autentificarea în doi factori (2FA)

Din interfața web, mergi la Setări → Securitate → Autentificare în doi factori și activează TOTP.

Actualizări regulate

Verifică periodic releases oficiale Gitea și actualizează binarul:

sudo systemctl stop gitea
sudo wget -O /usr/local/bin/gitea https://dl.gitea.com/gitea/1.22.x/gitea-1.22.x-linux-amd64
sudo chmod 755 /usr/local/bin/gitea
sudo systemctl start gitea

Pasul 12: Backup automat Gitea

Gitea include o comandă nativă de backup:

sudo -u gitea gitea dump -c /etc/gitea/app.ini --tempdir /tmp

Aceasta generează un fișier .zip cu repository-urile, baza de date, atașamentele și configurația. Planifică această comandă printr-un cron job:

sudo crontab -e

0 2 * * * sudo -u gitea gitea dump -c /etc/gitea/app.ini --tempdir /tmp --file /backup/gitea-$(date +\%Y\%m\%d).zip

Pentru o infrastructură mai robustă cu backup-uri gestionate, administrarea serverelor CLIQHOST poate automatiza acest proces pentru tine.

Gitea vs. alternative: când să alegi ce?

Soluție	RAM minim	Ușurință instalare	Funcționalități
Gitea	~100 MB	⭐⭐⭐⭐⭐	Medii
GitLab CE	~4 GB	⭐⭐	Avansate
Gogs	~50 MB	⭐⭐⭐⭐⭐	De bază
Forgejo	~100 MB	⭐⭐⭐⭐⭐	Medii

Gitea oferă cel mai bun echilibru între funcționalitate și consum de resurse — perfect pentru echipe mici și proiecte personale care vor să stea departe de GitHub sau GitLab Cloud.

Probleme frecvente și soluții

Gitea nu pornește

sudo journalctl -u gitea -n 50 --no-pager

Verifică permisiunile pe /etc/gitea/app.ini și /var/lib/gitea/.

Eroare 502 Bad Gateway în Nginx

Asigură-te că Gitea rulează pe portul 3000:

sudo ss -tlnp | grep 3000

Repository-urile nu se clonează prin SSH

Verifică că portul SSH Gitea (implicit 22 sau 2222) este deschis în firewall și că cheia SSH este adăugată corect în contul Gitea.

Concluzie

Instalarea Gitea pe un VPS Linux este un proces relativ simplu care îți oferă control total asupra codului sursă, fără dependența de servicii terțe. Cu o configurare corectă — Nginx ca reverse proxy, SSL activ, backup automat și 2FA — obții o platformă Git robustă și sigură.

Dacă vrei să pornești rapid, alege un VPS SSD sau un VPS NVMe de la CLIQHOST, optimizat pentru aplicații Linux. Ai nevoie de ajutor cu configurarea? Echipa noastră de administrare servere este disponibilă să te asiste. Consultă și blogul CLIQHOST pentru mai multe ghiduri tehnice practice.