Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Installation

Complete installation guide for zer0 Browser across all platforms.

📥 Download Options

Latest Stable Release

Visit our GitHub Releases page to download the latest version:

Platform
Download
File Size
Version

Windows 10/11

zer0-Setup-x.x.x.exe

~150 MB

macOS 10.13+

zer0-x.x.x.dmg

~145 MB

Linux (AppImage)

zer0-x.x.x.AppImage

~155 MB

Linux (Debian)

zer0-x.x.x.deb

~155 MB

🪟 Windows Installation

Prerequisites

  • Windows 10 (64-bit) or Windows 11

  • 4 GB RAM (minimum)

  • 500 MB free disk space

Installation Steps

  1. Download the Installer

  2. Run the Installer

    • Double-click zer0-Setup-x.x.x.exe

    • If Windows SmartScreen appears, click "More info" → "Run anyway"

    • Follow the installation wizard

  3. Choose Installation Options

    • Select installation directory (default: C:\Program Files\zer0)

    • Choose to create desktop shortcut

    • Select "Add to Start Menu"

  4. Complete Installation

    • Click "Install" and wait for the process to finish

    • Click "Finish" to launch zer0

First launch may take 30-60 seconds while Tor network connection is established.

Windows-Specific Notes

  • Firewall: Windows Firewall will prompt for network access - click "Allow"

  • Antivirus: Some antivirus software may flag Tor components - add zer0 to exceptions

  • Updates: Auto-updates are enabled by default

🍎 macOS Installation

Prerequisites

  • macOS 10.13 (High Sierra) or later

  • 4 GB RAM (minimum)

  • 500 MB free disk space

Installation Steps

  1. Download the DMG

  2. Open the DMG File

    • Double-click the downloaded DMG

    • A new window will open showing the zer0 icon

  3. Install the Application

    • Drag the zer0 icon to the Applications folder

    • Eject the DMG from Finder

  4. First Launch

    • Open Applications folder

    • Right-click zer0 → "Open"

    • Click "Open" when Gatekeeper prompts (first time only)

macOS Gatekeeper: On first launch, you must right-click and select "Open" to bypass Gatekeeper restrictions.

macOS-Specific Notes

  • Permissions: Grant network permissions when prompted

  • M1/M2 Macs: Native Apple Silicon support included

  • Updates: Check for updates via zer0 menu → "Check for Updates"

🐧 Linux Installation

Prerequisites

  • 64-bit Linux distribution

  • 4 GB RAM (minimum)

  • 500 MB free disk space

Option 1: AppImage (Universal)

Recommended for most distributions

Optional: Add to Applications Menu

Option 2: Debian/Ubuntu Package

For Debian-based distributions

Linux-Specific Notes

  • Dependencies: Most are bundled, but you may need libappindicator1 on some distros

  • Wayland: Fully supported alongside X11

  • Snap/Flatpak: Coming soon!

🔧 Post-Installation Setup

First Launch Checklist

After installing zer0, complete these initial setup steps:

Recommended Settings

  1. Privacy Settings

    • ✅ Always-on Incognito Mode (enabled by default)

    • ✅ Block all third-party cookies

    • ✅ Block trackers and ads

    • ✅ WebRTC leak prevention

  2. Network Settings

    • ✅ Tor routing enabled

    • ✅ Auto-connect on startup

    • ⚠️ Use bridges if in restricted regions

  3. Earning Settings

    • ✅ Earn $zer0 while browsing

    • ✅ Privacy-preserving ads (optional, higher earnings)

    • ✅ Auto-stake rewards (optional)

🔄 Updating zer0

Automatic Updates (Recommended)

zer0 checks for updates automatically and will notify you when a new version is available:

  1. Click the update notification

  2. Click "Download and Install"

  3. Browser will restart with the new version

Manual Updates

  1. Download the latest installer from Releases

  2. Run the installer (Windows/macOS) or replace the AppImage (Linux)

  3. Your wallet, settings, and data are preserved

🚨 Troubleshooting

Installation fails on Windows

Solutions:

  • Disable antivirus temporarily during installation

  • Run installer as Administrator (right-click → "Run as administrator")

  • Ensure you have enough disk space (500 MB minimum)

  • Check Windows Update is current

macOS says "zer0 is damaged"

Solution:

This is a false positive from Gatekeeper. Our app is safe and open-source.

Linux AppImage won't run

Solutions:

Tor won't connect

Solutions:

  • Check your internet connection

  • Disable VPN temporarily (can conflict with Tor)

  • If in a restricted region, enable Tor bridges in Settings

  • Check firewall isn't blocking zer0

🔐 Verifying Your Installation

Check Installation Integrity

Verify your download wasn't tampered with:

All releases are GPG-signed. Advanced users can verify signatures using our public key.

📚 Next Steps

🎯 First Steps

Learn the basics and start using zer0

⚙️ System Requirements

Detailed compatibility information

💬 Get Support

Need help? We're here for you

🐛 Found a Bug?

Report installation issues on our GitHub Issues page or email dev@zer0.build.

PreviousQuick Start GuideNextFirst Steps

Last updated