Tonnet Browser

The TON Network Browser

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

   

   

_{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 & .t.me sites through decentralized TON DNS and RLDP protocol, without gateways or third-party proxies, and more under the hood.

Features

Browsing .ton .t.me .adnl tonbags Decentralized DNS Tabs, bookmarks, history	Wallet W5 v5r1, send/receive Real-time balance, NFTs HTTP 402 payments	Privacy 3-hop garlic routing Anti-fingerprinting No telemetry	Storage TON Storage client File browser, seeding Decentralized P2P
Routing DHT relay discovery 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
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.5.4.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.5.4.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.5.4-universal.dmg && hdiutil attach TON-Browser-1.5.4-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.5.4.AppImage
./TON-Browser-1.5.4.AppImage

# Debian/Ubuntu
sudo dpkg -i TON-Browser-1.5.4.deb

One-line install: Open Terminal and run:

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

# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-1.5.4.deb && sudo dpkg -i TON-Browser-1.5.4.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
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
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
bash scripts/download-binaries.sh
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 41
Frontend	React 19, TypeScript
Styling	Tailwind CSS v4
State	Zustand
TON Proxy	Tonutils-Proxy - HTTP proxy, decentralized gateway
WS Bridge	tonutils-bridge - JSON-RPC 2.0 over WebSocket
TON Storage	tonutils-storage - P2P file storage daemon
Anonymity	adnl-tunnel - garlic routing, DHT relay discovery
Transport	RLDP over ADNL over UDP

Contact

• Website: tonnet.resistance.dog
• Community: @ResistanceTools
• 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
• Tonutils-Proxy - HTTP proxy for decentralized .ton site access
• tonutils-bridge - WebSocket-ADNL bridge for wallet and blockchain queries
• adnl-tunnel - Garlic routing relay for anonymous browsing
• tonutils-storage - TON Storage daemon