diff --git a/docs/deployment-self-hosted.md b/docs/deployment-self-hosted.md
index b75e820..7d98216 100644
--- a/docs/deployment-self-hosted.md
+++ b/docs/deployment-self-hosted.md
@@ -202,3 +202,14 @@ backend/frontend/postgrest PŘED flyway** — slabý server se s běžícím sta
 + buildem dusil tak, že flyway nedostal spojení k DB (run 369: 9,5 min → EOF).
 Výpadek app vrstvy během deploye = navržená degradace (Loxone fallback,
 TeltoCharge failsafe).
+
+
+## CI gotcha: prázdný commit / duplicitní SHA na main+dev netriggeruje deploy (2026-06-13)
+
+`git commit --allow-empty` ani push **stejného SHA** na main i dev hned po sobě
+nespustí reálný `deploy` job (Gitea workflow se naváže na poslední ref = dev →
+`if: github.ref == 'refs/heads/main'` false → skip; combined status hlásí
+„success", protože skip ≠ fail — viz per-JOB kontrola). **Re-trigger deploye
+vždy NEPRÁZDNÝM commitem na main, který v tu chvíli NENÍ na dev** (unikátní SHA
+s ref=main). Ověření, že deploy reálně proběhl: `flyway_schema_history` má
+nejnovější V### (ne jen combined status success).