# Guida all'inizializzazione di Gitea

Dopo aver eseguito `docker compose up -d`, aprire il browser su `https://your-domain.com`.

Al primo accesso Gitea mostra una pagina di configurazione iniziale.

---

## 1. Database

Selezionare **SQLite3** come database. È la scelta più semplice per un'installazione self-hosted personale e non richiede configurazione aggiuntiva.

> Se si preferisce PostgreSQL o MySQL, aggiungere il relativo container nel `docker-compose.yml` prima di procedere.

---

## 2. Impostazioni generali

| Campo | Valore da inserire |
|---|---|
| **Titolo del sito** | Il nome che vuoi dare al tuo server Git |
| **URL base** | `https://your-domain.com` |

---

## 3. Impostazioni SSH

| Campo | Valore da inserire |
|---|---|
| **Porta SSH del server** | `2222` (o la porta esterna che hai impostato in `docker-compose.yml`) |

> Questa impostazione dice a Gitea quale porta mostrare negli URL SSH nell'interfaccia web. Deve corrispondere alla porta **sinistra** del mapping in `docker-compose.yml` (es. `2222:22` → inserire `2222`).

---

## 4. Account amministratore

Scorrere fino in fondo alla pagina e compilare la sezione **Account amministratore**:

- **Nome utente** – il tuo username admin
- **Password** – scegli una password sicura
- **Email**

> Se non si compila questa sezione, il primo utente che si registra diventa automaticamente admin.

---

## 5. Completare l'installazione

Cliccare **Installa Gitea**. La pagina si ricaricherà e si verrà reindirizzati alla home del proprio server Git.

---

## 6. Verifica

- Accedere con le credenziali admin appena create
- Creare un repository di test
- Verificare che l'URL SSH mostrato da Gitea contenga la porta corretta (es. `ssh://git@your-domain.com:2222/...`)