From fa4739e06121f2ce8ad4205d9d7cf266d7110ec2 Mon Sep 17 00:00:00 2001
From: Joakim Persson <joakim.persson@icloud.com>
Date: Fri, 10 Apr 2026 19:40:19 +0200
Subject: [PATCH] Fix exec examples: specify -u developer since container
 starts as root

---
 DOCKER_HUB.md      | 8 ++++----
 README.md          | 4 ++--
 docker-compose.yml | 2 +-
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/DOCKER_HUB.md b/DOCKER_HUB.md
index 85efdd4..69bb63c 100644
--- a/DOCKER_HUB.md
+++ b/DOCKER_HUB.md
@@ -46,10 +46,10 @@ docker run -d --name devbox \
   joakimp/opencode-devbox:latest sleep infinity
 
 # Shell 1: run opencode
-docker exec -it devbox opencode
+docker exec -it -u developer devbox opencode
 
 # Shell 2 (separate terminal): aws, git, etc.
-docker exec -it devbox bash
+docker exec -it -u developer devbox bash
 
 # When done
 docker rm -f devbox
@@ -59,8 +59,8 @@ With docker-compose this is simpler:
 
 ```bash
 docker compose up -d
-docker compose exec devbox opencode     # terminal 1
-docker compose exec devbox bash         # terminal 2
+docker compose exec -u developer devbox opencode     # terminal 1
+docker compose exec -u developer devbox bash         # terminal 2
 ```
 
 ## Environment Variables
diff --git a/README.md b/README.md
index 72fe70e..deddb6e 100644
--- a/README.md
+++ b/README.md
@@ -76,10 +76,10 @@ docker compose run --rm devbox
 docker compose up -d
 
 # Attach a shell to the running container
-docker compose exec devbox bash
+docker compose exec -u developer devbox bash
 
 # Or run a single command inside it
-docker compose exec devbox aws --version
+docker compose exec -u developer devbox aws --version
 ```
 
 > `run` creates a new container (cleaned up with `--rm`). `exec` attaches to an already running one.
diff --git a/docker-compose.yml b/docker-compose.yml
index c97fd1f..461e105 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -3,7 +3,7 @@
 # Usage:
 #   cp .env.example .env    # configure your provider and keys
 #   docker compose up -d
-#   docker compose exec devbox opencode
+#   docker compose exec -u developer devbox opencode
 #
 # Or for interactive one-shot:
 #   docker compose run --rm devbox