Tonnet Browser

Browse the TON Network, privately.

       

---

Caution

No external security audit. This browser and its embedded wallet have not undergone a third-party audit. The code is open-source and subject to internal reviews, but has not been independently verified. Use at your own risk;

About

Tonnet Browser is a native desktop browser for the TON Network. It resolves .ton, .t.me, .adnl, .eth (ENS), and .sol (SNS) through decentralized DNS and delivers content over RLDP directly from the network.

All traffic goes through ADNL, either peer-to-peer or via multi-hop tunnels. A WebSocket bridge connects directly to the TON blockchain, removing any dependency on centralized APIs like TonCenter or TonAPI. Anti-fingerprinting, per-domain isolation, built-in TON Storage, and optional experimental Messenger are included. No telemetry, no tracking, fully open source.

Features

Browsing .ton .t.me .adnl TON Storage Bags + more TLDs	Wallet W5 v5r1, send/receive Experimental HTTP 402	Privacy Garlic routing Anti-fingerprinting Per-domain isolation No telemetry	Storage TON Storage P2P File browser Download & seed
Bridge WebSocket JSON-RPC Direct to TON No centralized API dependency	Security Process sandboxing SSRF protection IPC hardening Encrypted history	Messenger Experimental groupchat DHT room discovery Opt-in network	Fingerprint Canvas, WebGL, Audio WebRTC leak blocking Generic User-Agent

Installation

Installer	DMG (Universal)	AppImage x64 · .deb x64

Windows

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

1. Download and run TON-Browser-Setup-2.4.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-2.4.0.exe -OutFile TonBrowser.exe; Unblock-File TonBrowser.exe; .\TonBrowser.exe

macOS

Open the .dmg and drag TON Browser to Applications.

The app is ad-hoc signed (no paid Apple Developer ID), so Gatekeeper does not trust it yet. Clear the quarantine flag once:

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-2.4.0-universal.dmg && hdiutil attach TON-Browser-2.4.0-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

Still crashes on launch (Apple Silicon)? Older builds (≤ 2.2.0) shipped unsigned and crash immediately on M1/M2/M3. Re-sign once, then reopen:

codesign --force --deep --sign - /Applications/TON\ Browser.app

Linux

# AppImage
chmod +x TON-Browser-2.4.0-x86_64.AppImage
./TON-Browser-2.4.0-x86_64.AppImage

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

One-line install: Open Terminal and run:

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

# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-2.4.0-amd64.deb && sudo dpkg -i TON-Browser-2.4.0-amd64.deb

ARM64 Linux builds are also published as TON-Browser-2.4.0-arm64.AppImage and TON-Browser-2.4.0-arm64.deb.

Building

Prerequisites

• Node.js 22+
• npm 9+
• Go 1.24+

Development

git clone https://github.com/TONresistor/Tonnet-Browser.git
cd Tonnet-Browser
npm install
bash scripts/build-binaries-from-source.sh
npm run dev

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

Socials

• Website: tonnet.resistance.dog
• Community: @ResistanceForum
• Channel: @ResistanceTools

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