From 7896614cfd229b15e187227eafdfc8a26b276df4 Mon Sep 17 00:00:00 2001
From: root <root@almasrv.thehomelesssherlock.com>
Date: Mon, 23 Mar 2026 02:10:59 +0000
Subject: [PATCH] docs: add gotcha 5 - all host data lives under /opt/<stack>/

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 COOLIFY-TEMPLATE.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/COOLIFY-TEMPLATE.md b/COOLIFY-TEMPLATE.md
index ccf7ef7..bbdeec2 100644
--- a/COOLIFY-TEMPLATE.md
+++ b/COOLIFY-TEMPLATE.md
@@ -223,3 +223,15 @@ Si vuelve a bajar a 2 (upgrade del OS, etc.), todos los deploys fallarán con ex
 ```bash
 grep MaxSessions /etc/ssh/sshd_config   # debe ser >= 10
 ```
+
+### Gotcha 5 — Todos los datos del host están en /opt/<stack>/
+
+Convención de este servidor: todos los bind mounts van bajo `/opt/<nombre-stack>/`.
+Antes de hardcodear rutas en un compose, verificar siempre:
+
+```bash
+ls /opt/<stack>/     # ej: /opt/adguard/, /opt/authentik/, /opt/gitea/, etc.
+```
+
+Si existe el directorio con datos → usar bind mount a esa ruta.
+Si no existe → crear el directorio antes de desplegar, o usar named volume.