ZenBrowserMirrors/docs
1
0
Fork 0
mirror of https://github.com/zen-browser/docs.git synced 2025-07-07 17:05:34 +02:00
Code Issues Projects Releases Packages Wiki Activity

remove obsolete macOS install guide

Browse source
This commit is contained in:
nitro 2024-09-09 22:58:51 +02:00
parent 19d260011e
commit c96693779d
2 changed files with 0 additions and 73 deletions
Download patch file Download diff file Expand all files Collapse all files

5
content/faq.md
View file

@ -41,11 +41,6 @@ If you'd like to support the development of Zen Browser, you can do so through t
Your support helps the team maintain and enhance Zen Browser for everyone!
## "Zen Browser is damaged and can't be opened" on macOS
If you encounter the message "Zen Browser is damaged and can't be opened" on macOS, it is because Zen Browser is not signed with an official Apple Developer License. This triggers the Gatekeeper security feature, which prevents unsigned or unverified apps from running.
If you encounter this error please follow our [[install-macos | Installing Zen Browser on MacOS]] guide
## How do I use the Split View feature?
> [!hint] Use shortcuts to perform Split View actions faster!

68
content/guides/install-macos.md
View file

@ -1,68 +0,0 @@
---
title: Installing Zen Browser on MacOS
---
This [[guides/index|guide]] provides step-by-step instructions for installing Zen Browser on macOS, including how to bypass macOS Gatekeeper due to the lack of an official Developer License. It also explains how users can support the Zen Browser team by donating towards obtaining a Developer License.
> [!question]- Why Bypassing Gatekeeper is Necessary
> Zen Browser currently requires users to bypass macOS Gatekeeper because the app does not have a Developer License from Apple. This license, which costs 100 euros annually, is necessary for official app signing and distribution. Unfortunately, due to limited resources, it is not within the Zen Browser team's ability to purchase this license at the moment.
> If you'd like to help Zen Browser obtain a Developer License and improve the installation experience, you can make a donation. Contributions will directly support the team in reaching this goal.
> - **Patreon**: [https://www.patreon.com/zen_browser](https://www.patreon.com/zen_browser)
> - **Ko-fi**: [https://ko-fi.com/zen_browser](https://ko-fi.com/zen_browser)
## Step 1: Download the Latest Version
- Download the latest Zen Browser DMG.
- Once downloaded, open the DMG file. You might need to zoom out a bit to see everything.
![[open-dmg.png]]
## Step 2: Install Zen Browser
- Drag the Zen Browser icon to the Applications folder.
## Step 3: Bypass Gatekeeper
Upon trying to open Zen Browser, you may encounter a message indicating the file is damaged. This happens because the app does not have a valid developer signature and is using an Ad-hoc sign.
![[gatekeeper.png]]
### To bypass this warning:
1. *Open Terminal.*
2. Run one of the following commands:
- To bypass Gatekeeper for the current installed version:
```bash
xattr -c '/Applications/Zen Browser.app/'
```
- To bypass Gatekeeper for all versions of the app:
```bash
xattr -d com.apple.quarantine '/Applications/Zen Browser.app/'
```
3. After running the command, if successful, Terminal will return a blank line.
![[blank space.png]]
## Step 4: Open Zen Browser
- Open Zen Browser from the Applications folder.
- Complete the onboarding process.
- If you use Little Snitch (LS), accept or block any connections as needed. For a browser, it is generally not recommended to block connections other than telemetry.
## Step 5: Restart Zen Browser
At the time of writing, there seems to be a bug with Zen Browser where the menu might not display correctly on the initial start. To fix this, quit Zen Browser (`⌘Q`) and reopen it.
![[broken-menu.png]]
![[fixed menu.png]]
You should now have a fully functional Zen Browser on your macOS. If you need to uninstall Zen, you can use Pearcleaner.
>[!check]+ Good news! 🎊
>We've reached two goals for app-signing in the past days! That means that macOS & Windows builds no longer will be rejected by the systems! 🥳
>
>![[kofi-goal.jpg]]
---
Thanks to [SenpaiHunters](https://github.com/SenpaiHunters) for creating this guide
Original Post: [Issue #53](https://github.com/zen-browser/desktop/issues/53)