Skip to main content

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โ€‹