Installation & Setup
Platform-specific installation and license activation guide
Installation & Setup
Accessing Downloads
ZeroTrace OSINT is exclusively available through the ZeroTrace Dashboard:
- Log in to your ZeroTrace Dashboard
- Go to the Firmware page
- Navigate to the ZeroTrace OSINT tab (only visible after purchase)
- Select your platform from available downloads
Platform Downloads
| Platform | File | Architecture | Format |
|---|---|---|---|
| Windows | Windows amd64 (x64) | x86-64 | .exe installer |
| macOS Intel | macOS amd64 (Intel) | x86-64 | Binary with .app |
| macOS Apple Silicon | macOS arm64 (Apple Silicon) | ARM64 | Native binary |
| Linux | Linux amd64 (AppImage) | x86-64 | Self-contained AppImage |
| Linux | Linux 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
- Download
Windows amd64 (x64).exefrom Dashboard - 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
- Download
macOS amd64 (Intel)from Dashboard - Open Terminal
Set Executable Permission
# Navigate to Downloads (Where the file was saved)
cd ~/Downloads
# Make binary executable
chmod +x zerotrace-osintLaunch Application
# Run directly
./zerotrace-osint
# OR add to PATH for global access
sudo mv zerotrace-osint /usr/local/bin/
zerotrace-osint # Run from anywhereDownload & Setup
- Download
macOS arm64 (Apple Silicon)from Dashboard - Open Terminal
Set Executable Permission
# Navigate to Downloads (Where the file was saved)
cd ~/Downloads
# Make binary executable
chmod +x zerotrace-osintLaunch Application
# Run directly
./zerotrace-osint
# OR add to PATH for global access
sudo mv zerotrace-osint /usr/local/bin/
zerotrace-osint # Run from anywhereDownload & Setup
- Download
Linux amd64 (AppImage)from Dashboard - Open Terminal in download directory
Make Executable & Launch
# Make executable
chmod +x zerotrace-osint
# Run
./zerotrace-osintDownload & Install
# Download from Dashboard, then:
sudo dpkg -i zerotrace-osint.debLaunch
# From anywhere
zerotrace-osint
# OR from applications menuRequirements
- Ubuntu 20.04+ or Debian 11+
- Internet connection for license validation
Uninstall
sudo dpkg -r zerotrace-osintFile Permissions & SUDO
Running as standard user (recommended):
./zerotrace-osintIf network access fails, try:
# Add your user to network groups
sudo usermod -aG dialout $USER
# Log out and back in for changes to take effectLast resort - run with sudo (not recommended):
sudo ./zerotrace-osintLicense Activation
First Launch Activation
- Start ZeroTrace OSINT
- Log in with your ZeroTrace account credentials
- Application contacts licensing servers
- Upon success: 3-hour session begins
- 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":
- Do NOT reinstall
- Check your system time
- Synchronize with NTP (see troubleshooting below)
- 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 reinstallTime 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 nowNetwork 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 firewallmacOS "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-osintUpdating to Latest Version
New versions are released through the Dashboard when available:
- Check ZeroTrace Dashboard → OSINT tab for updates
- Download latest version
- Close current application
- Install new version (overwrites old installation)
- 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-osintLinux (AppImage)
# Simply delete the binary
rm zerotrace-osint-*.AppImageLinux (Debian)
sudo dpkg -r zerotrace-osint