Installation Guide

This guide covers detailed installation instructions for all supported platforms. Choose your operating system below.

System Requirements

Linux

Component Minimum Recommended
CPU 2 cores 4+ cores
RAM 4 GB 8+ GB
Disk 10 GB free 50+ GB SSD
Kernel 5.4+ 6.0+

Dependencies

  • LXC - Container runtime for process isolation
  • WireGuard - VPN for network isolation
  • Xpra - GUI forwarding for visual boundaries
  • cryptsetup - LUKS encryption for data at rest

Linux Installation

Ubuntu / Debian

Add the Zero repository and install:

# Add GPG key
curl -fsSL https://repo.zero.io/gpg.key | sudo gpg --dearmor -o /usr/share/keyrings/zero.gpg

# Add repository
echo "deb [signed-by=/usr/share/keyrings/zero.gpg] https://repo.zero.io/apt stable main" | \
  sudo tee /etc/apt/sources.list.d/zero.list

# Install
sudo apt update
sudo apt install zero

Fedora / RHEL

# Add repository
sudo dnf config-manager --add-repo https://repo.zero.io/rpm/zero.repo

# Install
sudo dnf install zero

Arch Linux

# Using yay (AUR helper)
yay -S zero

# Or manually
git clone https://aur.archlinux.org/zero.git
cd zero
makepkg -si

AppImage (Universal)

# Download AppImage
curl -LO https://releases.zero.io/latest/zero.AppImage
chmod +x zero.AppImage

# Run
./zero.AppImage

Windows Installation

Download and run the MSI installer:

  1. Download from releases.zero.io
  2. Run zero-setup.msi
  3. Follow the installation wizard
  4. Restart when prompted
Windows Requirements: Windows 10 (1903+) or Windows 11, with Hyper-V enabled for container support.

Verify Installation

# Check version
zero --version

# Check system compatibility
zero doctor

# View installed components
zero components list

Uninstalling

Linux

# Ubuntu/Debian
sudo apt remove zero

# Fedora
sudo dnf remove zero

# Complete removal (including data)
sudo zero uninstall --purge

Windows

Use "Add or Remove Programs" in Windows Settings, or run:

msiexec /x zero-setup.msi

Next Steps