diff --git a/Docker.md b/Docker.md
new file mode 100644
index 0000000..fa67414
--- /dev/null
+++ b/Docker.md
@@ -0,0 +1,30 @@
+# Docker — правила пересборки
+
+## Что менялось → что делать
+
+| Изменение | Действие (DEV) | Действие (PROD) |
+|---|---|---|
+| `src/*.svelte`, `src/*.css`, `lib/*.js` | Ничего (HMR) | Пересборка образа + деплой |
+| `vite.config.js` | `docker compose restart builder` | Пересборка образа + деплой |
+| `email-gen/` (pug, миксины) | `docker compose build && up -d` | Синхронизация файлов на сервере |
+| `package.json` (зависимости) | `docker compose build && up -d` | Пересборка образа + деплой |
+| `Dockerfile` | `docker compose build && up -d` | Пересборка образа + деплой |
+| `data/` (JSON данные) | Автоматически (volume) | Автоматически (volume) |
+
+## ⚠️ Сборка для прода
+
+Mac — Apple Silicon (ARM), сервер — x86_64. **Всегда:**
+
+```bash
+docker build --platform linux/amd64 -f z51-pug-builder/Dockerfile -t vaaspekter-builder .
+```
+
+Без `--platform linux/amd64` контейнер упадёт с `exec format error`.
+
+## Контейнеры
+
+| Контейнер | Порт | Описание |
+|---|---|---|
+| `va-builder` | 6001→5173 | Основное приложение (Vite) |
+| `va-email-gen-api` | 8787 | Рендер Pug → HTML |
+| `gitea` | 3000 | Git-сервер |