Files
mates-infra/docker-services/gitea/README.md
T
mates 444191d16d feat: initial infra repo
- 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
2026-08-01 16:25:58 +02:00

1.6 KiB
Raw Blame History

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:

  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

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

📁 Volumes

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

📚 Dokumentace