Document required host directories to prevent root-owned bind mount issues

2026-04-12 23:52:59 +02:00
parent f7bd21b9fe
commit b3cfe641bb
2 changed files with 25 additions and 1 deletions
@@ -42,6 +42,18 @@ docker compose run --rm devbox

 ## Usage

+### Prerequisites
+
+Bind-mounted directories must exist on the host before starting the container. Docker creates missing directories as root-owned, which causes permission issues.
+
+```bash
+# Required: workspace for your projects
+mkdir -p ~/projects
+
+# If mounting opencode config (recommended for persistent settings)
+mkdir -p ~/.config/opencode
+```
+
 ### Connecting to the container

 From your laptop, SSH into the remote server where Docker is running, then start the container: