mates
444191d16d
- docker-services: 14 generic compose templates (portainer, npm, vaultwarden, gitea, jotty, nextcloud-aio, rustdesk, audiobookshelf, calibre-web, plex, erugo, jswiki, speedtest, watchtower) - install-scripts: bash scripts for Ubuntu server bootstrap, docker, portainer, npm, backup, restore - ansible: 4 playbooks (bootstrap, deploy-services, update-services, security-hardening) + roles skeleton - hermes-install: Hermes CLI setup on macOS - macos-setup: Brewfile + osx-defaults + fish-config - home-nas-tools: metadata index for NAS projects (no binaries) - docs: architecture, security, contributing - README, LICENSE (MIT), .gitignore
71 lines
1.6 KiB
Markdown
71 lines
1.6 KiB
Markdown
# 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/)
|