diff --git a/docs/src/development/linux.md b/docs/src/development/linux.md
index e7dc49dc821e..71e5690691a9 100644
--- a/docs/src/development/linux.md
+++ b/docs/src/development/linux.md
@@ -72,6 +72,9 @@ Zed has basic support for both modes. The mode is selected at runtime. If you're
 
 ## Flatpak
 
+> [!WARNING]
+> Zed's current Flatpak integration simply exits the sandbox on startup. Workflows that rely on flatpak's sandboxing may not work as expected. 
+
 To build & install the flatpak package locally follow the steps below:
 
 1. Install flatpak for your distribution as outlined [here](https://flathub.org/setup).