Skip to Content
Getting StartedPrecompiled Binaries

Precompiled Binaries

The fastest way to get started with TOS Network is to download our precompiled binaries. These are ready-to-run executables that don’t require compilation or complex setup.

📥 Download Options

Latest Release: v2.1.0

PlatformArchitectureDownloadSizeSHA256
Linuxx86_64tos-linux-x64.tar.gz 45MBa1b2c3d4...
LinuxARM64tos-linux-arm64.tar.gz 42MBe5f6g7h8...
macOSx86_64tos-macos-x64.dmg 38MBi9j0k1l2...
macOSARM64 (M1/M2)tos-macos-arm64.dmg 36MBm3n4o5p6...
Windowsx86_64tos-windows-x64.zip 41MBq7r8s9t0...

Beta Releases

VersionRelease DatePlatform SupportDownload
v2.2.0-beta12024-04-10All platformsBeta Downloads 
v2.1.5-rc12024-03-28Linux, macOSRC Downloads 

🔐 Verification

GPG Verification

Always verify downloads using our GPG signatures:

# Download our public key curl -O https://releases.tos.network/tos-release.asc gpg --import tos-release.asc # Verify the binary gpg --verify tos-linux-x64.tar.gz.sig tos-linux-x64.tar.gz

SHA256 Verification

# Linux/macOS sha256sum tos-linux-x64.tar.gz echo "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6 tos-linux-x64.tar.gz" | sha256sum -c # Windows (PowerShell) Get-FileHash tos-windows-x64.zip -Algorithm SHA256

🐧 Linux Installation

Quick Install Script

# Download and run the installation script curl -sSL https://install.tos.network | bash # Or download manually wget https://releases.tos.network/v2.1.0/tos-linux-x64.tar.gz tar -xzf tos-linux-x64.tar.gz sudo mv tos-* /usr/local/bin/

Manual Installation

# Extract the archive tar -xzf tos-linux-x64.tar.gz # Move binaries to system path sudo cp tos-daemon /usr/local/bin/ sudo cp tos-wallet /usr/local/bin/ sudo cp tos-miner /usr/local/bin/ # Make executable sudo chmod +x /usr/local/bin/tos-* # Verify installation tos-daemon --version

Package Managers

Ubuntu/Debian (APT)

# Add TOS repository curl -fsSL https://packages.tos.network/gpg | sudo apt-key add - echo "deb https://packages.tos.network/apt stable main" | sudo tee /etc/apt/sources.list.d/tos.list # Install sudo apt update sudo apt install tos-network

CentOS/RHEL/Fedora (RPM)

# Add repository sudo rpm --import https://packages.tos.network/gpg sudo yum-config-manager --add-repo https://packages.tos.network/rpm/tos.repo # Install sudo yum install tos-network # or for newer systems: sudo dnf install tos-network

Arch Linux (AUR)

# Using yay yay -S tos-network # Using makepkg git clone https://aur.archlinux.org/tos-network.git cd tos-network makepkg -si

🍎 macOS Installation

# Add TOS tap brew tap tos-network/tos # Install brew install tos-network # Verify tos-daemon --version

Manual Installation

# Download and mount DMG curl -O https://releases.tos.network/v2.1.0/tos-macos-x64.dmg hdiutil mount tos-macos-x64.dmg # Copy applications cp -R /Volumes/TOS\ Network/TOS\ Daemon.app /Applications/ cp -R /Volumes/TOS\ Network/TOS\ Wallet.app /Applications/ # Unmount hdiutil unmount /Volumes/TOS\ Network # Add CLI tools to PATH echo 'export PATH="/Applications/TOS Daemon.app/Contents/MacOS:$PATH"' >> ~/.zshrc source ~/.zshrc

macOS Security

For macOS Gatekeeper, you may need to allow the application:

# If you see "unverified developer" warning sudo xattr -rd com.apple.quarantine /Applications/TOS\ Daemon.app sudo xattr -rd com.apple.quarantine /Applications/TOS\ Wallet.app

🪟 Windows Installation

  1. Download the Windows installer: tos-windows-x64-installer.exe
  2. Run the installer as Administrator
  3. Follow the installation wizard
  4. Launch TOS Network from the Start Menu

Manual Installation

# Download using PowerShell Invoke-WebRequest -Uri "https://releases.tos.network/v2.1.0/tos-windows-x64.zip" -OutFile "tos-windows-x64.zip" # Extract Expand-Archive -Path "tos-windows-x64.zip" -DestinationPath "C:\Program Files\TOS Network" # Add to PATH $env:PATH += ";C:\Program Files\TOS Network" [Environment]::SetEnvironmentVariable("PATH", $env:PATH, [EnvironmentVariableTarget]::Machine)

Windows Package Manager (winget)

# Install using winget winget install TOSNetwork.TOSNetwork # Verify installation tos-daemon --version

Chocolatey

# Install using Chocolatey choco install tos-network # Verify tos-daemon --version

📱 Mobile Applications

Android

VersionMin AndroidDownloadSize
v1.5.0Android 8.0+Google Play 35MB
v1.5.0Android 8.0+APK Direct 35MB

iOS

VersionMin iOSDownloadSize
v1.5.0iOS 13.0+App Store 42MB
v1.5.0-betaiOS 13.0+TestFlight 42MB

🐳 Docker Images

Official Docker Images

# Pull the latest image docker pull tosnetwork/tos-daemon:latest # Run daemon docker run -d \ --name tos-daemon \ -p 2080:2080 \ -v tos-data:/data \ tosnetwork/tos-daemon:latest # Run wallet docker run -it \ --name tos-wallet \ -v tos-wallet-data:/wallet \ tosnetwork/tos-wallet:latest

Available Tags

TagDescriptionSize
latestLatest stable release120MB
v2.1.0Specific version120MB
betaLatest beta release125MB
alpineAlpine-based (smaller)85MB

Docker Compose

version: '3.8' services: tos-daemon: image: tosnetwork/tos-daemon:latest ports: - "2080:2080" - "2081:2081" volumes: - tos-data:/data environment: - TOS_NETWORK=mainnet - TOS_RPC_BIND=0.0.0.0:2081 restart: unless-stopped tos-wallet: image: tosnetwork/tos-wallet:latest depends_on: - tos-daemon volumes: - tos-wallet-data:/wallet environment: - TOS_DAEMON_HOST=tos-daemon - TOS_DAEMON_PORT=2081 restart: unless-stopped volumes: tos-data: tos-wallet-data:

⚙️ First Run Configuration

Initial Setup

After installation, run the initial setup:

# Create configuration directory mkdir -p ~/.tos # Generate default configuration tos-daemon --generate-config # Edit configuration (optional) nano ~/.tos/tos.conf

Basic Configuration

# ~/.tos/tos.conf [network] # Network to connect to (mainnet, testnet) network = "mainnet" # P2P listening port p2p_port = 2080 # RPC listening port rpc_port = 2081 [rpc] # Enable RPC server enabled = true # RPC bind address bind_address = "127.0.0.1:2081" # RPC authentication (optional) username = "your_username" password = "your_secure_password" [mining] # Enable mining enabled = false # Mining threads (0 = auto-detect) threads = 0 # Mining address address = "tos1your_mining_address_here"

🚀 Quick Start

Start the Daemon

# Start in foreground (for testing) tos-daemon # Start in background tos-daemon --daemon # Start with custom config tos-daemon --config /path/to/tos.conf

Create a Wallet

# Create new wallet tos-wallet create --name "my-wallet" # List wallets tos-wallet list # Open existing wallet tos-wallet open --name "my-wallet"

Check Status

# Get daemon status tos-daemon status # Get blockchain info tos-wallet info # Check balance tos-wallet balance

🔧 Troubleshooting

Common Issues

”Command not found”

# Check if binaries are in PATH which tos-daemon # If not found, add to PATH echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc

Permission Denied

# Make binaries executable chmod +x /usr/local/bin/tos-* # Or run with sudo sudo tos-daemon

Port Already in Use

# Check what's using the port netstat -tulpn | grep 2080 # Use different port tos-daemon --p2p-port 2082

Platform-Specific Issues

macOS Gatekeeper

If you see security warnings:

# Allow the application sudo spctl --add /Applications/TOS\ Daemon.app sudo spctl --enable --label "TOS Network"

Windows Antivirus

Some antivirus software may flag mining software. Add exclusions for:

  • C:\Program Files\TOS Network\
  • %APPDATA%\TOS\

Linux Dependencies

If you encounter library errors:

# Ubuntu/Debian sudo apt install libssl1.1 libcrypto++6 # CentOS/RHEL sudo yum install openssl-libs cryptopp # Arch Linux sudo pacman -S openssl crypto++

📊 System Requirements

Minimum Requirements

ComponentSpecification
CPU2 cores, 2.0 GHz
RAM4 GB
Storage100 GB available space
Network10 Mbps internet connection
OSLinux, macOS 10.15+, Windows 10+
ComponentSpecification
CPU4+ cores, 3.0+ GHz
RAM8+ GB
Storage500+ GB SSD
Network100+ Mbps internet connection
OSLatest stable version

🔄 Updating

Automatic Updates

# Check for updates tos-daemon --check-update # Enable automatic updates tos-daemon --auto-update

Manual Updates

# Download new version curl -O https://releases.tos.network/latest/tos-linux-x64.tar.gz # Stop daemon tos-daemon stop # Replace binaries tar -xzf tos-linux-x64.tar.gz sudo cp tos-* /usr/local/bin/ # Restart daemon tos-daemon start

Package Manager Updates

# APT (Ubuntu/Debian) sudo apt update && sudo apt upgrade tos-network # Homebrew (macOS) brew upgrade tos-network # Chocolatey (Windows) choco upgrade tos-network

📞 Support

If you encounter issues:

  1. Check the logs: ~/.tos/logs/tos.log
  2. Visit our documentation: docs.tos.network 
  3. Join our Discord: discord.gg/tos-network 
  4. Report bugs: github.com/tos-network/tos/issues 

“Don’t Trust, Verify it” - Always verify download integrity and only download from official sources!

Last updated on