Logo

Installation & Setup

Platform-specific installation and license activation guide

Installation & Setup

Accessing Downloads

ZeroTrace OSINT is exclusively available through the ZeroTrace Dashboard:

  1. Log in to your ZeroTrace Dashboard
  2. Go to the Firmware page
  3. Navigate to the ZeroTrace OSINT tab (only visible after purchase)
  4. Select your platform from available downloads

Platform Downloads

PlatformFileArchitectureFormat
WindowsWindows amd64 (x64)x86-64.exe installer
macOS IntelmacOS amd64 (Intel)x86-64Binary with .app
macOS Apple SiliconmacOS arm64 (Apple Silicon)ARM64Native binary
LinuxLinux amd64 (AppImage)x86-64Self-contained AppImage
LinuxLinux amd64 (Debian)x86-64.deb package

Version Updates

Always download the latest version from the Dashboard. Older versions may have outdated SSL certificates causing authentication failures.

Installation by Platform

Download & Install

  1. Download Windows amd64 (x64).exe from Dashboard
  2. Double-click the exe

Prerequisites

  • Windows 10 or newer
  • Internet connection for license validation

macOS requires manual permission setup due to unsigned/notarized binaries.

Download & Setup

  1. Download macOS amd64 (Intel) from Dashboard
  2. Open Terminal

Set Executable Permission

# Navigate to Downloads (Where the file was saved)
cd ~/Downloads

# Make binary executable
chmod +x zerotrace-osint

Launch Application

# Run directly
./zerotrace-osint

# OR add to PATH for global access
sudo mv zerotrace-osint /usr/local/bin/
zerotrace-osint  # Run from anywhere

Download & Setup

  1. Download macOS arm64 (Apple Silicon) from Dashboard
  2. Open Terminal

Set Executable Permission

# Navigate to Downloads (Where the file was saved)
cd ~/Downloads

# Make binary executable
chmod +x zerotrace-osint

Launch Application

# Run directly
./zerotrace-osint

# OR add to PATH for global access
sudo mv zerotrace-osint /usr/local/bin/
zerotrace-osint  # Run from anywhere

Download & Setup

  1. Download Linux amd64 (AppImage) from Dashboard
  2. Open Terminal in download directory

Make Executable & Launch

# Make executable
chmod +x zerotrace-osint

# Run
./zerotrace-osint

Download & Install

# Download from Dashboard, then:
sudo dpkg -i zerotrace-osint.deb

Launch

# From anywhere
zerotrace-osint

# OR from applications menu

Requirements

  • Ubuntu 20.04+ or Debian 11+
  • Internet connection for license validation

Uninstall

sudo dpkg -r zerotrace-osint

File Permissions & SUDO

Running as standard user (recommended):

./zerotrace-osint

If network access fails, try:

# Add your user to network groups
sudo usermod -aG dialout $USER
# Log out and back in for changes to take effect

Last resort - run with sudo (not recommended):

sudo ./zerotrace-osint

License Activation

First Launch Activation

  1. Start ZeroTrace OSINT
  2. Log in with your ZeroTrace account credentials
  3. Application contacts licensing servers
  4. Upon success: 3-hour session begins
  5. Session timer visible in application window

Requirements for Activation

✓ Internet connection (will not work offline) ✓ Accurate system clock (±5 minutes required) ✓ Valid license (purchased and registered to your account) ✓ Firewall allowing outbound HTTPS (port 443)

Activation Failures

Most Common: Time Sync

If activation fails immediately with "invalid license":

  1. Do NOT reinstall
  2. Check your system time
  3. Synchronize with NTP (see troubleshooting below)
  4. Restart the application

Post-Installation Troubleshooting

SSL/Certificate Errors on Launch

Error: "SSL Certificate Verification Failed" or "SSL_ERROR_*"

Cause: Your installed version has outdated SSL certificates (app is outdated)

Solution:

# Option 1 - Download fresh copy
# 1. Go to ZeroTrace Dashboard
# 2. Download latest version
# 3. Uninstall current version completely
# 4. Install fresh version

# Option 2 - Clear cache (if applicable)
rm -rf ~/.zerotrace/  # Linux/macOS
rmdir %APPDATA%\ZeroTrace  # Windows (PowerShell: Remove-Item -Recurse)

# Then reinstall

Time Synchronization Issues

Error: "Invalid License" but license shows active in Dashboard

Fix:

# Linux
sudo timedatectl set-ntp on
sudo ntpdate -s time.nist.gov

# macOS
sudo sntp -sS time.apple.com
sudo date  # Verify time is correct

# Windows PowerShell (as Admin)
Get-Date
# If incorrect, Settings > Time & Language > Date & Time > Sync now

Network Connectivity Issues

Error: "Cannot connect to license server" or timeout

Checks:

# Test internet connectivity
ping 8.8.8.8

# Test DNS resolution
nslookup zerotrace.pw

# Check firewall blocking HTTPS
# macOS: System Preferences > Security & Privacy > Firewall Options
# Linux: sudo ufw status
# Windows: Windows Defender Firewall > Allow app through firewall

macOS "App is damaged" Error

Error: "The app 'ZeroTrace OSINT' is damaged and cannot be opened"

Solution:

# Remove quarantine attribute
sudo xattr -rd com.apple.quarantine /path/to/zerotrace-osint

# Then run
./zerotrace-osint

Updating to Latest Version

New versions are released through the Dashboard when available:

  1. Check ZeroTrace Dashboard → OSINT tab for updates
  2. Download latest version
  3. Close current application
  4. Install new version (overwrites old installation)
  5. Launch updated version

Always update when notified. Outdated versions may have expired SSL certificates causing authentication failures.

Uninstallation

Windows

  • Control Panel → Programs → Programs and Features
  • Find "ZeroTrace OSINT"
  • Click "Uninstall"

macOS

# If in Applications folder
rm -rf /Applications/zerotrace-osint.app

# If in PATH
which zerotrace-osint  # Find location
rm /path/to/zerotrace-osint

Linux (AppImage)

# Simply delete the binary
rm zerotrace-osint-*.AppImage

Linux (Debian)

sudo dpkg -r zerotrace-osint

On this page