Tonnet Browser

The TON Network Browser

About • Features • Privacy & Security • Installation • Usage • Settings • Contact

Download

   

_{Linux .deb · Windows Portable · All releases}

---

Home	Start Page
Storage	Settings

About

Tonnet Browser is the first native cross-platform desktop browser for the TON Network with built-in anonymous garlic routing. It connects to .ton sites through the decentralized TON DNS and RLDP protocol - no centralized gateways, no third-party proxies.

It also includes a built-in TON Storage client for downloading and seeding bags on TON's decentralized storage network.

Features

• Native .ton, .adnl and .t.me domain browsing
• Decentralized DNS resolution via TON blockchain
• Built-in TON Storage client (download, seed, pause)
• Standard browser features
• Cross-platform: Linux, Windows, macOS

Privacy & Security

Tonnet Browser matches Tor Browser's anti-fingerprinting capabilities while offering a superior decentralized infrastructure through TON Network. Built with a privacy-first architecture, it combines proven anonymity techniques with the resilience and censorship-resistance of blockchain-based routing.

Anonymous Browsing

• 3-hop garlic routing
• Auto circuit rotation
• Direct mode for speed without anonymity

Anti-Fingerprinting

• Canvas, WebGL, Audio protection
• WebRTC IP leak blocking
• Hardware enumeration disabled
• Font, timezone, screen spoofing
• Generic User-Agent (no browser ID)

Data Isolation

• First-party isolation (per-domain sessions)
• Cookie auto-delete (inactivity-based)
• Clear on exit (enabled by default)
• History modes: Memory (RAM) or Encrypted

Security Architecture

• Multi-process sandboxing
• Rate limiting (30 nav/s, 10 storage ops/s)
• Input validation (URL, paths, ports)
• No telemetry or tracking

Transparency

• Open Source: Full codebase available for audit
• MIT License: Freedom to inspect, modify, and verify
• No telemetry or data collection
• No third-party trackers

Installation

Platform	Download
Windows	Installer · Portable
macOS	DMG (Universal)
Linux	AppImage · .deb

Windows

Your browser may warn that the file is from an unknown source. Click "Keep" to download.

1. Download and run TON.Browser.Setup.1.0.0.exe
2. Follow the installation prompts
3. Launch TON Browser from the Start menu

One-line install: Open PowerShell and run:

irm https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON.Browser.Setup.1.0.0.exe -OutFile TonBrowser.exe; Unblock-File TonBrowser.exe; .\TonBrowser.exe

macOS

Open the .dmg and drag TON Browser to Applications.

# If blocked by Gatekeeper
xattr -cr /Applications/TON\ Browser.app

One-line install: Open Terminal and run:

curl -LO https://github.com/TONresistor/tonnet-browser/releases/latest/download/TON.Browser-1.0.0-universal.dmg && hdiutil attach TON.Browser-1.0.0-universal.dmg && cp -R "/Volumes/TON Browser 1.0.0-universal/TON Browser.app" /Applications/ && hdiutil detach "/Volumes/TON Browser 1.0.0-universal" && xattr -cr /Applications/TON\ Browser.app && open /Applications/TON\ Browser.app

Linux

# AppImage
chmod +x TON.Browser-1.0.0.AppImage
./TON.Browser-1.0.0.AppImage

# Debian/Ubuntu
sudo dpkg -i ton-browser_1.0.0_amd64.deb

One-line install: Open Terminal and run:

# AppImage
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON.Browser-1.0.0.AppImage && chmod +x TON.Browser-1.0.0.AppImage && ./TON.Browser-1.0.0.AppImage

# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/ton-browser_1.0.0_amd64.deb && sudo dpkg -i ton-browser_1.0.0_amd64.deb

Usage

1. Launch TON Browser
2. Click "Connect to TON Network"
3. Wait for sync to complete (status bar shows "Connected to TON Network")
4. Enter a .ton address in the URL bar (e.g., foundation.ton)
5. Browse the decentralized web

TON Storage

1. Navigate to ton://storage or click the Storage icon
2. Click "Add Bag"
3. Paste a 64-character hex bag ID
4. Monitor download progress in real-time

Settings

Access settings via the gear icon or navigate to ton://settings.

Category	Settings
General	Homepage, Restore tabs, Anonymous mode, Circuit rotation
Network	Proxy port, Storage port, Auto-connect, Connection timeout
Storage	Download path, Update interval, Auto-seed
Appearance	Zoom levels, Bookmarks bar, Status bar, Themes
Privacy	Clear browsing data, Clear on exit, Cookie settings
History	History mode, Maximum entries, View history
Bookmarks	Manage bookmarks, Folders, Import/Export
Advanced	Verbosity levels, Sync test domain

Building

Prerequisites

• Node.js 18+
• npm 9+

Development

git clone https://github.com/TONresistor/Tonnet-Browser.git
cd Tonnet-Browser
npm install
npm run dev

Production Build

# Linux
npm run build:linux

# Windows
npm run build:win

# macOS
npm run build:mac

Builds are output to the release/ directory.

Tests

npm test

Tech Stack

Component	Technology
Framework	Electron 39
Frontend	React 19, TypeScript
Styling	Tailwind CSS
State	Zustand
TON Proxy	tonnet-proxy
TON Storage	tonutils-storage
Transport	RLDP over ADNL over UDP

Contact

• Website: tonnet.resistance.dog
• Telegram: @zkproof
• Issues: Report bugs or request features

License

MIT License. See LICENSE for details.

Acknowledgments

• Tor Project - Inspiration for anonymous browsing
• BitTorrent - Inspiration for P2P file sharing
• tonutils-go - TON protocol implementation
• tonnet-proxy - HTTP proxy with garlic routing for TON sites
• tonutils-storage - TON Storage daemon