fix: Docker permissions in ci

Author: codeadict

.env.example

@@ -2,5 +2,7 @@
 HTTPBIN_HTTP_PORT=8080
 HTTPBIN_HTTPS_PORT=8443
 
-# Optional: Set DOCKER_USER for Linux/GitHub Actions
+# Optional: Set to your username to avoid file permission issues (macOS/Linux)
+# DOCKER_USER=$(whoami)
+# Or use numeric UID:GID format
 # DOCKER_USER=1000:1000

.github/workflows/ci.yml

@@ -28,9 +28,6 @@ jobs:
           - otp: '25.3'
             rebar3: '3.23.0'
 
-    env:
-      DOCKER_USER: "${{ github.actor }}"
-
     steps:
       - name: Checkout
         uses: actions/checkout@v4

docker-compose.yml

@@ -8,10 +8,9 @@ services:
     build:
       context: .
       dockerfile: Dockerfile.caddy
-    # In GitHub Actions we want to access the files created
-    # by Caddy. However, in Linux these end up being owned by root
-    # because the container by default runs using the root user
-    # and we are not root in the GH action so we cannot access them.
+    # For local development, set DOCKER_USER to your username in .env
+    # to avoid file permission issues. In CI, this defaults to root.
+    # Example: DOCKER_USER=$(whoami)
     user: "${DOCKER_USER:-root}"
     environment:
       - HTTPBIN_HTTP_PORT=${HTTPBIN_HTTP_PORT:-8080}