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.
TON Site traffic goes through ADNL, either peer-to-peer or via multi-hop tunnels. A WebSocket bridge provides TON blockchain access. Experimental Messenger uses its own authenticated TON QUIC client and DHT discovery, independently of the proxy and its tunnel settings. Anti-fingerprinting, per-domain isolation and built-in TON Storage are included. No telemetry, no tracking, fully open source.
Features
<b>Browsing</b>.ton .t.me .adnlTON Storage Bags+ more TLDs
<b>Wallet</b>W5 v5r1, send/receiveExperimental HTTP 402
<b>Privacy</b>Garlic routingAnti-fingerprintingPer-domain isolationNo telemetry
<b>Storage</b>TON Storage P2PFile browserDownload & seed
<b>Bridge</b>WebSocket JSON-RPCDirect to TONNo centralized API dependency
<b>Security</b>Process sandboxingSSRF protectionIPC hardeningEncrypted history
<b>Messenger</b>Persistent public roomsTON QUIC and DHTIndependent client
<b>Fingerprint</b>Canvas, WebGL, AudioWebRTC leak blockingGeneric User-Agent
Installation
Windows
Your browser may warn that the file is from an unknown source. Click "Keep" to download.
- Download and run TON-Browser-Setup-2.7.0.exe
- Follow the installation prompts
- 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.7.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.7.0-universal.dmg && hdiutil attach TON-Browser-2.7.0-universal.dmg && cp -R "/Volumes/TON Browser 2.7.0-universal/TON Browser.app" /Applications/ && hdiutil detach "/Volumes/TON Browser 2.7.0-universal" && 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:
>
> bash > codesign --force --deep --sign - /Applications/TON\ Browser.app >
Linux
# AppImage
chmod +x TON-Browser-2.7.0-x86_64.AppImage
./TON-Browser-2.7.0-x86_64.AppImage
# Debian/Ubuntu
sudo dpkg -i TON-Browser-2.7.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.7.0-x86_64.AppImage && chmod +x TON-Browser-2.7.0-x86_64.AppImage && ./TON-Browser-2.7.0-x86_64.AppImage
# Debian/Ubuntu
curl -LO https://github.com/TONresistor/Tonnet-Browser/releases/latest/download/TON-Browser-2.7.0-amd64.deb && sudo dpkg -i TON-Browser-2.7.0-amd64.deb
ARM64 Linux builds are also published as TON-Browser-2.7.0-arm64.AppImage and TON-Browser-2.7.0-arm64.deb.
Building
Prerequisites
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
Documentation
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
License
MIT License. See LICENSE for details.
Acknowledgments