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. Генерация конфигурации Gitea

⚠️ Важно: Генерируем .gitea.env ПОСЛЕ настройки .env:

docker-compose up generate-config

Это создаст .gitea.env с подстановкой ваших значений из .env.

3. Запуск

docker-compose up -d

При каждом запуске автоматически:

1. 🔧 Обновляется .gitea.env из .env
2. 🔄 Применяется новая конфигурация
3. 🚀 Запускаются все сервисы

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

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

При первом входе укажите:

• Название сайта
• Логин и пароль администратора
• Опционально: капча, регистрация, другие настройки

---

Автоматические бэкапы в 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

---

Устранение проблем

Изменения в .env не применяются

Пересоздайте контейнеры:

docker-compose down
docker-compose up -d --force-recreate

Сброс настроек

Для полного сброса удалите данные:

docker-compose down
sudo rm -rf data/ postgres-data/

---