diff --git a/README.md b/README.md
index 79de004..a7761f9 100644
--- a/README.md
+++ b/README.md
@@ -68,3 +68,39 @@ docker run -d --name kadr-photo-editor -p 3000:3000 ^
   `http://192.168.31.240:8188`); из контейнера адрес доступен как исходящий
   адрес локальной сети.
 - **Порт**: по умолчанию 3000, меняется через `PORT`.
+
+## Сборка образа в Gitea (Actions)
+
+Репозиторий: `https://git.byte-mate.ru/Coder/photo-editor` (ветка `main`).
+Workflow лежит в `.gitea/workflows/build.yml` и запускается **вручную**:
+вкладка **Actions** → **Run workflow** → выбрать ветку → нажать кнопку.
+
+После успешного прогона образ публикуется во встроенный registry Gitea:
+
+```powershell
+docker pull git.byte-mate.ru/coder/photo-editor:latest
+docker run -d --name kadr-photo-editor -p 3000:3000 ^
+  -v "$env:USERPROFILE\.codex:/root/.codex" ^
+  -v "${PWD}\history:/app/history" ^
+  -e COMFY_URL=http://192.168.31.240:8188 ^
+  git.byte-mate.ru/coder/photo-editor:latest
+```
+
+Требования для работы кнопки:
+
+1. **Actions включены** на инстансе (уже включены).
+2. **Зарегистрирован runner** (`act_runner`). Сейчас раннеров нет — без него
+   задания будут висеть в очереди. Регистрация на машине с Docker:
+
+   ```bash
+   # токен регистрации: Администрирование → Actions → Runners → Create new runner
+   docker run -d --name gitea-runner --restart always \
+     -v /var/run/docker.sock:/var/run/docker.sock \
+     -v gitea-runner:/data \
+     -e GITEA_INSTANCE_URL=https://git.byte-mate.ru \
+     -e GITEA_RUNNER_REGISTRATION_TOKEN=<token> \
+     gitea/act_runner:latest
+   ```
+
+3. После регистрации нажмите «Run workflow» — образ соберётся Buildx'ом и
+   уедет в registry.