diff --git a/docs/deploy-traefik.md b/docs/deploy-traefik.md
index 064f7c0..8e37909 100644
--- a/docs/deploy-traefik.md
+++ b/docs/deploy-traefik.md
@@ -61,6 +61,7 @@ Traefik для сертификата создаёт TXT `_acme-challenge.auth
 
 ```bash
 mkdir -p /opt/auth-portal/data
+chown -R 1000:1000 /opt/auth-portal/data   # контейнер работает от uid 1000 (node)
 cd /opt/auth-portal
 
 # из репозитория или curl:
@@ -147,6 +148,17 @@ docker compose down
 # НЕ делайте down -v без бэкапа — сотрёт ACME (auth_portal_traefik_letsencrypt)
 ```
 
+> **Переход с root-образа (версии до не-root).** Контейнер теперь работает от
+> uid 1000 (`node`). Если `./data` и `app.db` созданы старым контейнером под
+> root, при старте будет `SqliteError: SQLITE_READONLY`. Один раз выполнить:
+>
+> ```bash
+> cd /opt/auth-portal
+> docker compose down
+> sudo chown -R 1000:1000 ./data
+> docker compose up -d
+> ```
+
 ---
 
 ## Что внутри compose