diff --git a/docs/src/linux.md b/docs/src/linux.md
index 4abd7de8ba..6e62300ec8 100644
--- a/docs/src/linux.md
+++ b/docs/src/linux.md
@@ -123,17 +123,26 @@ If Vulkan is configured correctly, and Zed is still slow for you, please [file a
 
 ### I can't open any files
 
-### Zed isn't remembering my login
-
 ### Clicking links isn't working
 
-All of these features are provided by XDG desktop portals, specifically:
+These features are provided by XDG desktop portals, specifically:
 
 - `org.freedesktop.portal.FileChooser`
 - `org.freedesktop.portal.OpenURI`
 
 Some window managers, such as `Hyprland`, don't provide a file picker by default. See [this list](https://wiki.archlinux.org/title/XDG_Desktop_Portal#List_of_backends_and_interfaces) as a starting point for alternatives.
 
+### Zed isn't remembering my API keys
+
+### Zed isn't remembering my login
+
+These feature also requires XDG desktop portals, specifically:
+
+- `org.freedesktop.portal.Secret` or
+- `org.freedesktop.Secrets`
+
+Zed needs a place to securely store secrets such as your Zed login cookie or your OpenAI API Keys and we use a system provided keychain to do this. Examples of packages that provide this are `gnome-keyring`, `KWallet` and `keepassxc` among others.
+
 ### Could not start inotify
 
 Zed relies on inotify to watch your filesystem for changes. If you cannot start inotify then Zed will not work reliably.