# Gitea – self-hosted Git

> Lehký Git server (alternativa k GitLabu). Web UI, API, SSH.

## 📋 Přehled

- **Image:** `docker.gitea.com/gitea:1.27.1`
- **Porty:** `3000` (web), `222` (SSH)
- **User:** `1000:1000`
- **Network:** `bridge`

## 🚀 Instalace

```bash
cp .env.example .env
nano .env

docker compose up -d
```

Po startu otevři `http://<server>:3000/` a dokonči install wizard:

1. **Database:** SQLite3 (default)
2. **Site Title:** libovolný
3. **Admin Username:** `admin` (nebo `mates`)
4. **Admin Password:** silné heslo
5. **Admin Email:** tvůj email
6. Ostatní default
7. **Install Gitea**

## 🌐 Přístup

- **Web:** `http://<server>:3000` (za HTTPS terminuj v NPM)
- **SSH git push:** `ssh://git@<server>:222/<user>/<repo>.git`
- **API:** `http://<server>:3000/api/v1/`

## 🔐 Bezpečnost

- **Změň admin heslo** hned po instalaci
- **DISABLE_REGISTRATION=false** – po registraci prvního admina vypni
- **HTTPS** – terminuj v NPM a přesměruj HTTP→HTTPS
- **2FA** – aktivuj pro admin účet

## 🔑 API Token

Vytvoření tokenu pro skripty:

1. User Settings → Applications
2. Název: `<script-name>`
3. Scopes: `read:user`, `write:user`, `read:repository`, `write:repository`
4. **Token ulož do keychainu**, ne do chatu

## 🔄 Aktualizace

```bash
docker compose pull
docker compose up -d
# DB migrace probíhá automaticky
```

## 📁 Volumes

| Mount | Účel |
|---|---|
| `./gitea:/data` | Repozitáře, DB, konfigurace, hooks |

## 📚 Dokumentace

- [Gitea Docker install](https://docs.gitea.com/installation/install-with-docker/)
- [Gitea API](https://docs.gitea.com/api/)