Tonnet Browser

The TON Network Browser

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

Download

   

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

tonnet.resistance.dog/download

---

Home	Start Page
Storage	Settings

About

Tonnet Browser is a native desktop browser for the TON Network. It connects directly to .ton sites through decentralized TON DNS and RLDP protocol, without centralized gateways or third-party proxies.

Features

Browsing 15 blockchain TLDs Decentralized DNS Tabs, bookmarks, history	Wallet W5 v5r1, send/receive NFT gallery, TON DNS HTTP 402 payments	Privacy 3-hop garlic routing Anti-fingerprinting No telemetry	Storage TON Storage client Download and seed Decentralized P2P
Routing Auto circuit rotation Direct mode for speed Censorship-resistant	Fingerprint Canvas, WebGL, Audio WebRTC leak blocking Generic User-Agent	Isolation Per-domain sessions Cookie auto-delete Encrypted history	Security Process sandboxing Rate limiting Open source, MIT

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.4.2.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.4.2.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.4.2-universal.dmg && hdiutil attach TON.Browser-1.4.2-universal.dmg && cp -R "/Volumes/TON Browser/TON Browser.app" /Applications/ && hdiutil detach "/Volumes/TON Browser" && xattr -cr /Applications/TON\ Browser.app && open /Applications/TON\ Browser.app

Linux

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

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

One-line install: Open Terminal and run:

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

# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/ton-browser_1.4.2_amd64.deb && sudo dpkg -i ton-browser_1.4.2_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
Appearance	Zoom levels, Bookmarks bar, Status bar, Tab orientation, Themes
Privacy	Clear browsing data, Clear on exit, Cookie settings, First-party isolation
Content Filtering	Block ads, trackers, miners, malware, annoyances
History	History mode, Maximum entries
Shortcuts	Keyboard shortcuts
Bookmarks	Manage bookmarks
Advanced	Verbosity levels, Sync test domain
Wallet	Payment mode, Spending limits, Per-site policies, API keys
About	Version, Links

Building

Prerequisites

• Node.js 22+
• 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