From a7785811584fb0f5daea32fcf3512706516cfc51 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Thibault=20de=20Vill=C3=A8le?=
<25150288+Thibaulltt@users.noreply.github.com>
Date: Thu, 25 Sep 2025 22:01:19 +0200
Subject: [PATCH 1/2] guides(1password): linux root, from 1P help page
The 1Password native app on Linux requires the binaries be owned by the
root user in order to verify a browser, even if it is already allowed in
their custom allowed browsers list.
---
content/docs/guides/1password.mdx | 18 +++++++++++++++++-
1 file changed, 17 insertions(+), 1 deletion(-)
diff --git a/content/docs/guides/1password.mdx b/content/docs/guides/1password.mdx
index e2170f1..22fa841 100644
--- a/content/docs/guides/1password.mdx
+++ b/content/docs/guides/1password.mdx
@@ -23,7 +23,7 @@ That being said, there are workaround methods to add Zen Browser to this _Truste
### Linux
-You can create a _Custom Allowed Browsers_ file that 1Password will use to allow Zen Browser -- or other non-officially supported browser-- to integrate with 1Password's desktop app.
+You can create a _Custom Allowed Browsers_ file that 1Password will use to allow Zen Browser -- or other non-officially supported browser-- to integrate with 1Password's desktop app. See: [Connect additional browsers to the 1Password app](https://support.1password.com/additional-browsers/?linux)
#### 1. Create 1Password's config directory
@@ -43,6 +43,22 @@ sudo touch /etc/1password/custom_allowed_browsers
echo "zen-bin" | sudo tee -a /etc/1password/custom_allowed_browsers
```
+#### 4. Ensure the right permissions are set for the Custom Allowed Browsers file
+
+```bash
+sudo chown root:root /etc/1password/custom_allowed_browsers && sudo chmod 755 /etc/1password/custom_allowed_browsers
+```
+
+This last step is mandatory.
+
+
+1Password requires the browser you are using (Zen in this case) and its binary both be owned by the `root` user and installed _directly_ to the system, not through a container-like package manager such as `flatpak` or `snap`.
+
+If they are not installed directly to the system, Zen _will not_ be able to talk to 1Password.
+
+If they are not owned by `root`, Zen _will_ be able to talk to the native 1Password app but will not be able to be verified by the "Native Core" of 1Password.
+
+
---
Special thanks to [u/xmansyx](https://www.reddit.com/user/xmansyx/) and [u/feelspeaceman](https://www.reddit.com/user/feelspeaceman/)
From 82a687b4c3c927c3eba6291700fe0b38c742aacb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Thibault=20de=20Vill=C3=A8le?=
<25150288+Thibaulltt@users.noreply.github.com>
Date: Fri, 26 Sep 2025 09:26:09 +0200
Subject: [PATCH 2/2] guides(1password): clearer instructions & messages
---
content/docs/guides/1password.mdx | 22 +++++++++++++---------
1 file changed, 13 insertions(+), 9 deletions(-)
diff --git a/content/docs/guides/1password.mdx b/content/docs/guides/1password.mdx
index 22fa841..5a9df6f 100644
--- a/content/docs/guides/1password.mdx
+++ b/content/docs/guides/1password.mdx
@@ -23,7 +23,17 @@ That being said, there are workaround methods to add Zen Browser to this _Truste
### Linux
-You can create a _Custom Allowed Browsers_ file that 1Password will use to allow Zen Browser -- or other non-officially supported browser-- to integrate with 1Password's desktop app. See: [Connect additional browsers to the 1Password app](https://support.1password.com/additional-browsers/?linux)
+You can create a _Custom Allowed Browsers_ file that 1Password will use to allow Zen Browser -- or other non-officially supported browser-- to integrate with 1Password's desktop app.
+
+
+Your 1Password application and the Zen browser need to be installed _directly_ to your machine, not through a container-like program such as `flatpak` or `snap`. Additionally, they both need to be owned by the `root` user.
+
+If they are not installed directly to the system, Zen _will not_ be able to talk to 1Password.
+
+If they are not owned by `root`, Zen _will_ be able to talk to the native 1Password app but will not be able to be verified by the "Native Core" of 1Password.
+
+See: [Connect additional browsers to the 1Password app](https://support.1password.com/additional-browsers/?linux)
+
#### 1. Create 1Password's config directory
@@ -49,15 +59,9 @@ echo "zen-bin" | sudo tee -a /etc/1password/custom_allowed_browsers
sudo chown root:root /etc/1password/custom_allowed_browsers && sudo chmod 755 /etc/1password/custom_allowed_browsers
```
-This last step is mandatory.
-
-
-1Password requires the browser you are using (Zen in this case) and its binary both be owned by the `root` user and installed _directly_ to the system, not through a container-like package manager such as `flatpak` or `snap`.
+#### 5. Restart both programs.
-If they are not installed directly to the system, Zen _will not_ be able to talk to 1Password.
-
-If they are not owned by `root`, Zen _will_ be able to talk to the native 1Password app but will not be able to be verified by the "Native Core" of 1Password.
-
+In order to pick up the changes you just made, both 1Password and Zen need to be restarted.
---