diff --git a/docs/server-setup.md b/docs/server-setup.md
index ed6211c..361e76e 100644
--- a/docs/server-setup.md
+++ b/docs/server-setup.md
@@ -163,6 +163,7 @@ cd /srv/woodpecker
 sudo cp .env.example .env
 openssl rand -hex 32        # copy the output
 sudo nano .env              # paste Woodpecker OAuth client ID + secret + the random hex
+sudo mkdir -p data && sudo chown -R 1000:1000 data   # v3 images run as uid 1000
 sudo docker compose up -d
 ```
 
diff --git a/infra/woodpecker/docker-compose.yml b/infra/woodpecker/docker-compose.yml
index 7969282..36dfae9 100644
--- a/infra/woodpecker/docker-compose.yml
+++ b/infra/woodpecker/docker-compose.yml
@@ -1,6 +1,7 @@
 # Woodpecker CI — server + one agent on the same VPS.
-# Copy this directory to /srv/woodpecker/, create .env from .env.example,
-# then: docker compose up -d
+# Copy this directory to /srv/woodpecker/, create .env from .env.example, then:
+#   sudo mkdir -p data && sudo chown -R 1000:1000 data   # v3 images run as uid 1000
+#   docker compose up -d
 # Web UI is bound to localhost only; Caddy proxies ci.vienalatina.com to it.
 
 services: