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

    Download zer0-Setup-x.x.x.exe from the releases page

  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

    Download zer0-x.x.x.dmg from the releases page

  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

# Download the AppImage
wget https://github.com/BrowserZer0/Zer0/releases/latest/download/zer0-x.x.x.AppImage

# Make it executable
chmod +x zer0-x.x.x.AppImage

# Run zer0
./zer0-x.x.x.AppImage

Optional: Add to Applications Menu

# Create desktop entry
cat > ~/.local/share/applications/zer0.desktop << EOF
[Desktop Entry]
Name=zer0 Browser
Exec=/path/to/zer0-x.x.x.AppImage
Icon=zer0
Type=Application
Categories=Network;WebBrowser;
EOF

Option 2: Debian/Ubuntu Package

For Debian-based distributions

# Download the .deb package
wget https://github.com/BrowserZer0/Zer0/releases/latest/download/zer0-x.x.x.deb

# Install the package
sudo dpkg -i zer0-x.x.x.deb

# Install dependencies if needed
sudo apt-get install -f

# Launch zer0
zer0

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:

# Remove quarantine flag
xattr -cr /Applications/zer0.app

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

Linux AppImage won't run

Solutions:

# Install FUSE (if missing)
sudo apt-get install fuse libfuse2

# Make sure it's executable
chmod +x zer0-x.x.x.AppImage

# Run with verbose output to see errors
./zer0-x.x.x.AppImage --verbose
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:

# Get SHA256 checksums from releases page
# Compare with your downloaded file

# Windows (PowerShell)
Get-FileHash zer0-Setup-x.x.x.exe -Algorithm SHA256

# macOS/Linux
shasum -a 256 zer0-x.x.x.dmg

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 [email protected].

PreviousQuick Start GuideNextFirst Steps

Last updated