From 0e669e621d400da4bddf61ea655bc818f2a568d9 Mon Sep 17 00:00:00 2001
From: Paul Rastoin <45004772+prastoin@users.noreply.github.com>
Date: Fri, 20 Jun 2025 14:47:04 +0200
Subject: [PATCH] Upgrade guide cache flush for 0.55 user permissions not found
 (#12765)

Related to https://github.com/twentyhq/twenty/issues/12651
---
 .../content/developers/self-hosting/upgrade-guide.mdx | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx b/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx
index d43e6aeae..20b694e69 100644
--- a/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx
+++ b/packages/twenty-website/src/content/developers/self-hosting/upgrade-guide.mdx
@@ -32,6 +32,17 @@ Upgrade your Twenty instance to use v0.55 image
 You don't need to run any command anymore, the new image will automatically care about running all required migrations.
 
 
+### `User does not have permission` error
+
+If you encounter authorization errors on most requests after upgrading, you may need to flush your cache to recompute the latest permissions.
+
+In your `twenty-server` container, run:
+```bash
+yarn command:prod cache:flush
+```
+
+This issue is specific to this Twenty version and should not be required for future upgrades.
+
 ### 0.54
 
 Since version `0.53`, no manual actions needed.