gitea-server/README.md

Gitea Server

Docker-окружение для развертывания Gitea с PostgreSQL, интеграцией S3 и автоматическими бэкапами.

Возможности

• ✅ Git сервер
• ✅ Интеграция с S3 (LFS, пакеты, аватары, вложения)
• ✅ Автоматические бэкапы в S3
• ✅ Отправка писем (SMTP)
• ✅ Gitea Actions (ранеры в отдельном репозитории)

⚠️ Ограничение: Container Registry требует https, не работает в локальном режиме.

Оглавление

1. Быстрый старт
2. Автоматические бэкапы в S3
3. Настройка ранеров
4. Устранение проблем

---

Быстрый старт

1. Конфигурация

# Копируем пример и настраиваем
cp env.example .env
nano .env  # Укажите пароли, S3 креденшелы, домен

2. Запуск

docker-compose up -d

Сервер доступен по адресу http://127.0.0.1:8080.

3. Первичная настройка

При первом входе в веб-интерфейс установки:

• Логин и пароль администратора - укажите вручную
• Настройки почты:
  • ☑️ Требовать подтверждение по электронной почте - поставьте галочку
  • ☑️ Разрешить почтовые уведомления - поставьте галочку

---

Автоматические бэкапы в S3

Используется решение docker-s3-backup — элегантный способ бэкапа всего проекта (база данных + файлы).

Сервис backup автоматически:

• Останавливает Gitea и PostgreSQL перед бэкапом
• Создает архив всего проекта (база данных + файлы)
• Загружает в S3 (папка gitea-backups/)
• Запускает сервисы обратно

Расписание настраивается в docker-compose.yaml (по умолчанию ежедневно в 05:00).

Восстановление

Просто скачайте архив из S3 и разархивируйте — всё готово к запуску.

---

Настройка ранеров

Gitea Actions ранеры находятся в отдельном репозитории: gromov-io/gitea-runner

Быстрая настройка:

1. Перейдите в админ-панель: http://127.0.0.1:8080/-/admin/actions/runners/
2. Нажмите "Создать новый раннер" и скопируйте токен
3. Следуйте инструкциям в репозитории gitea-runner