💻 Zentauri Installation Guide
This guide explains how to install Zentauri on macOS, Windows, and Linux, and how to handle macOS security permissions during first-time setup.
🍏 macOS Installation & First-Launch Security Setup
Because Zentauri is an open-source project and is not signed with a paid Apple Developer Certificate, macOS Gatekeeper will display a warning upon initial opening stating that the application is from an "unidentified developer".
Follow these simple steps for first-time installation:
Step 1: Download & Install
- Download the latest
.dmginstaller from ZenTauri GitHub Releases. - Open the
.dmgfile and drag ZenTauri to your Applications folder.
Step 2: Grant Security Permission (macOS Gatekeeper)
When opening Zentauri for the first time:
Option A (Recommended via System Settings):
- Open System Settings on your Mac.
- Navigate to Privacy & Security.
- Scroll down to the Security section.
- You will see a notification: "ZenTauri was blocked from use because it is not from an identified developer".
- Click Open Anyway (or Allow), then enter your Mac password or Touch ID when prompted.
Option B (Direct Right-Click):
- In Finder, navigate to your Applications folder.
- Right-click (or
Control+ Click) on ZenTauri.app. - Click Open from the context menu.
- On the pop-up warning, click Open.
🔄 Automatic Updates
Once Zentauri is installed and granted initial permission on your Mac:
- Seamless One-Click Updates: You do not need to repeat the security bypass for future updates!
- Simply open Settings (⚙️) inside Zentauri and click Check for Updates.
- Zentauri will automatically download and install future releases smoothly via the native Tauri updater.
🪟 Windows Installation
- Download the
.exeor.msiinstaller from GitHub Releases. - If Windows Defender SmartScreen displays a warning, click More info → Run anyway.
🐧 Linux Installation
- Download the
.AppImageor.debpackage from GitHub Releases. - For
.AppImage, make it executable before launching:bashchmod +x ZenTauri_*.AppImage ./ZenTauri_*.AppImage