docs: expand host requirements in README

This commit is contained in:
2026-04-12 16:00:16 +02:00
parent 6924d4e872
commit d4a390388c
+23 -3
View File
@@ -4,9 +4,29 @@ Stack Docker per un server Git self-hosted con interfaccia web HTTPS e accesso S
## Requisiti ## Requisiti
- **Docker** e **Docker Compose** ### Host
- **Un dominio** puntato all'IP della macchina host (necessario per Caddy, che ottiene il certificato TLS tramite Let's Encrypt). Può essere un dominio acquistato, un sottodominio, o un servizio DDNS gratuito come [NoIP](https://www.noip.com/) o [DuckDNS](https://www.duckdns.org/).
- Le porte **80**, **443** e **2222** aperte e raggiungibili dall'esterno. - **Sistema operativo**: Linux (qualsiasi distribuzione moderna)
- **Docker** (v20.10+) e **Docker Compose** (v2+) installati
- Spazio su disco sufficiente per i dati di Gitea (repository, DB)
### Porte
Le seguenti porte devono essere **libere sull'host** (non in uso da altri servizi) e **raggiungibili dall'esterno** (aperte sul firewall e, se dietro NAT, con port forwarding sul router):
| Porta | Uso |
|-------|-----|
| **80** | HTTP (Caddy, redirect a HTTPS) |
| **443** | HTTPS (Caddy + Let's Encrypt) |
| **2222** | SSH Git (Gitea) |
> La porta **3000** viene usata internamente da Gitea ed è esposta solo su `localhost` — non deve essere raggiungibile dall'esterno, ma deve essere libera sull'host.
### Dominio
È necessario un dominio puntato all'IP pubblico della macchina host. Caddy lo usa per ottenere automaticamente il certificato TLS tramite Let's Encrypt. Può essere:
- un dominio acquistato o un sottodominio
- un servizio DDNS gratuito come [NoIP](https://www.noip.com/) o [DuckDNS](https://www.duckdns.org/)
## Architettura ## Architettura