From 2aca9dc933f6c0b97dcc8af12b20a73981b22b2b Mon Sep 17 00:00:00 2001
From: Graham McIntire <graham@mcintire.me>
Date: Wed, 14 Jan 2026 09:33:12 -0600
Subject: [PATCH] Add data directory setup instructions to agent modal

The Docker agent runs as non-root user (UID 1000) for security. When
mounting host directories, users must create the data directory with
proper permissions before starting the container.

Added clear instructions to:
1. Create the data directory: mkdir -p data
2. Set proper ownership: chown -R 1000:1000 data
3. Then use the Docker Compose configuration

This fixes the 'unable to open database file' error when starting
the agent.
---
 lib/towerops_web/live/agent_live/index.html.heex | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

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}