> For the complete documentation index, see [llms.txt](https://docs.zer0.build/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zer0.build/getting-started/installation.md).

# Installation

Complete installation guide for zer0 Browser across all platforms.

***

## 📥 Download Options

### Latest Stable Release

Visit our [GitHub Releases](https://github.com/BrowserZer0/Zer0/releases/latest) page to download the latest version:

| Platform             | Download               | File Size | Version                                                  |
| -------------------- | ---------------------- | --------- | -------------------------------------------------------- |
| **Windows 10/11**    | `zer0-Setup-x.x.x.exe` | \~150 MB  | ![](https://img.shields.io/badge/version-1.0.0-blue.svg) |
| **macOS 10.13+**     | `zer0-x.x.x.dmg`       | \~145 MB  | ![](https://img.shields.io/badge/version-1.0.0-blue.svg) |
| **Linux (AppImage)** | `zer0-x.x.x.AppImage`  | \~155 MB  | ![](https://img.shields.io/badge/version-1.0.0-blue.svg) |
| **Linux (Debian)**   | `zer0-x.x.x.deb`       | \~155 MB  | ![](https://img.shields.io/badge/version-1.0.0-blue.svg) |

***

## 🪟 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

{% hint style="info" %}
**First launch may take 30-60 seconds** while Tor network connection is established.
{% endhint %}

### 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)

{% hint style="warning" %}
**macOS Gatekeeper:** On first launch, you must right-click and select "Open" to bypass Gatekeeper restrictions.
{% endhint %}

### 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**

```bash
# 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**

```bash
# 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**

```bash
# 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:

* [ ] **Create or Import Wallet** - Set up your $zer0 wallet
* [ ] **Save Seed Phrase** - Secure your recovery phrase offline
* [ ] **Configure Settings** - Review privacy and network settings
* [ ] **Test Tor Connection** - Verify anonymous browsing is active
* [ ] **Enable Notifications** - Get alerts for earnings and updates

### 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](https://github.com/BrowserZer0/Zer0/releases/latest)
2. Run the installer (Windows/macOS) or replace the AppImage (Linux)
3. Your wallet, settings, and data are preserved

***

## 🚨 Troubleshooting

<details>

<summary>Installation fails on Windows</summary>

**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

</details>

<details>

<summary>macOS says "zer0 is damaged"</summary>

**Solution:**

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

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

</details>

<details>

<summary>Linux AppImage won't run</summary>

**Solutions:**

```bash
# 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
```

</details>

<details>

<summary>Tor won't connect</summary>

**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

</details>

***

## 🔐 Verifying Your Installation

### Check Installation Integrity

Verify your download wasn't tampered with:

```bash
# 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
```

{% hint style="success" %}
**All releases are GPG-signed.** Advanced users can verify signatures using our [public key](https://zer0.build/pgp-key.asc).
{% endhint %}

***

## 📚 Next Steps

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>🎯 First Steps</strong></td><td>Learn the basics and start using zer0</td><td><a href="/pages/PDp7cgRpirx2NO0VMebJ">/pages/PDp7cgRpirx2NO0VMebJ</a></td></tr><tr><td><strong>⚙️ System Requirements</strong></td><td>Detailed compatibility information</td><td><a href="/pages/4AnMbFRcVsuqRvT97T6N">/pages/4AnMbFRcVsuqRvT97T6N</a></td></tr><tr><td><strong>💬 Get Support</strong></td><td>Need help? We're here for you</td><td><a href="https://github.com/Onesignature/Zer0-gitbook/blob/main/resources/support.md">https://github.com/Onesignature/Zer0-gitbook/blob/main/resources/support.md</a></td></tr></tbody></table>

***

## 🐛 Found a Bug?

Report installation issues on our [GitHub Issues](https://github.com/BrowserZer0/Zer0/issues) page or email <dev@zer0.build>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zer0.build/getting-started/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.