diff --git a/CLAUDE.md b/CLAUDE.md
index 3d51baf..3f23182 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -72,11 +72,10 @@ Then run `make setup` (starts Docker + installs plugins).
 
 ### After make install-plugins: fix cache permissions
 
-If the site returns a 500 error after plugin installation, the cache/logs/tmp directories may have wrong ownership (gpm runs as root inside the container). Fix with:
-
-```bash
-docker exec intotheeast_grav chown -R abc:users /app/www/public/cache /app/www/public/logs /app/www/public/tmp
-```
+If the site returns a 500 error after plugin installation or after recreating the container,
+run `make fix-perms`. This creates uid 1000 in the container, chowns `/var/www/html` to 1000:1000,
+and reloads Apache. Always run `make setup` (not just `make start`) after `docker compose down && up`
+to ensure permissions are correct.
 
 ### Language URL prefix