How to run TON Sites
👋 Introduction
TON Sites work almost like regular sites except for their installation. A number of additional actions are required to launch them. In this tutorial I will show you how to do it.
🖥 Running TON Site
Install Tonutils Reverse Proxy to use TON Proxy for your website.
Installation on any Linux
Download
wget https://github.com/ton-utils/reverse-proxy/releases/download/v0.2.0/tonutils-reverse-proxy-linux-amd64
chmod 777 tonutils-reverse-proxy-linux-amd64
Run
Run with domain configuration, and follow the steps:
./tonutils-reverse-proxy-linux-amd64 --domain your-domain.ton
Scan QR code from your terminal using Tonkeeper, Tonhub or any other wallet, execute transaction. Your domain will be linked to your site.
Run without domain
Alternatively, you can run in simple mode, with .adnl domain, if you don't have .ton or .t.me domain:
./tonutils-reverse-proxy-linux-amd64
Use
Now anyone can access your TON Site! Using ADNL address or domain.
If you want to change some settings, like proxy pass url - open config.json
file, edit and restart proxy. Default proxy pass url is http://127.0.0.1:80/
Proxy adds additional headers:
X-Adnl-Ip
- ip of client, and X-Adnl-Id
- adnl id of client
Installation on any other OS
Build it from sources using ./build.sh
, and run as in the step 2 for linux. Go environment is required to build.
👀 Further steps
🔍 Сhecking availability of the site
After completing all the steps of the method you selected, the TON Proxy should have started. If everything was successful, your site will be available at the ADNL address received at the corresponding step.
You can check the availability of the site by opening this address with the domain .adnl
. Also note that in order for the site to open, you must have a TON Proxy running in your browser, for example through an extension MyTonWallet.
📌 References
- TON Sites, TON WWW and TON Proxy
- Tonutils Reverse Proxy
- Authors: Andrew Burnosov (TG: @AndrewBurnosov), Daniil Sedov (TG: @sedov), George Imedashvili