diff --git a/lib/towerops_web/live/agent_live/index.html.heex b/lib/towerops_web/live/agent_live/index.html.heex
index 10425514..5371a318 100644
--- a/lib/towerops_web/live/agent_live/index.html.heex
+++ b/lib/towerops_web/live/agent_live/index.html.heex
@@ -213,8 +213,15 @@
 
               <div class="bg-zinc-50 dark:bg-zinc-800 border border-zinc-200 dark:border-zinc-700 rounded-lg p-4">
                 <h4 class="text-sm font-medium text-zinc-900 dark:text-zinc-100 mb-2">
-                  Docker Compose Example
+                  Docker Compose Setup
                 </h4>
+                <div class="mb-3 text-xs text-zinc-600 dark:text-zinc-400">
+                  <p class="mb-2">First, create the data directory with proper permissions:</p>
+                  <pre class="bg-zinc-100 dark:bg-zinc-900 rounded px-2 py-1 mb-2"><code>mkdir -p data && chown -R 1000:1000 data</code></pre>
+                  <p>
+                    Then create <code class="bg-zinc-100 dark:bg-zinc-900 rounded px-1">docker-compose.yml</code>:
+                  </p>
+                </div>
                 <pre class="text-xs font-mono text-zinc-600 dark:text-zinc-400 overflow-x-auto"><code>services:
   towerops-agent:
     image: {@agent_image}