- 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
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
cp .env.example .env
nano .env
docker compose up -d
Po startu otevři http://<server>:3000/ a dokonči install wizard:
- Database: SQLite3 (default)
- Site Title: libovolný
- Admin Username:
admin(nebomates) - Admin Password: silné heslo
- Admin Email: tvůj email
- Ostatní default
- 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:
- User Settings → Applications
- Název:
<script-name> - Scopes:
read:user,write:user,read:repository,write:repository - Token ulož do keychainu, ne do chatu
🔄 Aktualizace
docker compose pull
docker compose up -d
# DB migrace probíhá automaticky
📁 Volumes
| Mount | Účel |
|---|---|
./gitea:/data |
Repozitáře, DB, konfigurace, hooks |