diff --git a/.github/README.md b/.github/README.md
new file mode 100644
index 0000000..30bbc2c
--- /dev/null
+++ b/.github/README.md
@@ -0,0 +1,33 @@
+> [!WARNING]
+> **Это зеркало!** Основной репозиторий: [https://gromlab.ru/gromov/gitea-runner](https://gromlab.ru/gromov/gitea-runner)
+> 
+> - ⚠️ Pull requests и issues создавайте только в основном репозитории
+> - 🔄 Зеркало обновляется автоматически
+> - 🚫 Изменения здесь будут перезаписаны
+
+
+# Gitea Server Runner
+
+Docker-контейнер для запуска CI/CD раннера Gitea Actions.
+
+## Настройка
+
+1. Скопируйте `env.example` в `.env`
+2. Заполните переменные в `.env`:
+   - `GITEA_RUNNER_REGISTRATION_TOKEN` - токен из админ-панели Gitea
+   - `GITEA_INSTANCE_URL` - URL вашего Gitea сервера
+   - `GITEA_RUNNER_NAME` - уникальное имя раннера
+
+## Запуск
+
+```bash
+docker-compose up -d
+```
+
+Раннер автоматически зарегистрируется в Gitea при первом запуске.
+
+## actions/cache в Docker ранере
+Для работы actions/cache требуется настроить config.yaml согласно документации.  
+https://docs.gitea.com/usage/actions/act-runner#advanced-configurations
+
+host: - должна быть локальная сеть (пример: 192.168.0.35 ip текущего сервера). 127.0.0.1 не прокатит так-как у каждого контейнера свой изолированный 127.0.0.1.
\ No newline at end of file