MyTonCtrl

MyTonCtrl is a console application that is used for launching and managing TON blockchain nodes.

The extended documentation can be found at https://docs.ton.org/v3/documentation/nodes/mytonctrl/overview and https://docs.ton.org/v3/guidelines/nodes/overview.

Operating Systems

It is recommended to use Ubuntu 22.04 LTS or Ubuntu 24.04 LTS for using MyTonCtrl. However, the full list of tested OS is below:

Operating System	Status
Ubuntu 20.04 LTS	OK
Ubuntu 22.04 LTS	OK
Ubuntu 24.04 LTS	OK
Debian 10	Deprecated
Debian 11	OK
Debian 12	OK
Debian 13	Not supported

Installation

Please note that during the installation and upgrade procedures, MyTonCtrl will need to escalate privileges using the sudo or su methods in order to upgrade / install system wide components. Depending on your environment, you may be prompted to enter the password for the root or sudo user.

Modes

There are three main installation modes: liteserver, validator and collator. They all compile and install TON components and run node. Use liteserver mode if you want to use your node as Liteserver only. Use validator mode if you want to participate in the validator elections (you still can use that node as Liteserver). Use collator if you want your node to collate blocks for validators.

Learn more about node types: https://docs.ton.org/v3/documentation/nodes/overview

Install

1. Download installation script:

   wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh

2. Run script with desired options:

   sudo bash install.sh -m <mode>

   Or for Debian:

   su root -c 'bash install.sh -m <mode>'

To view all available installation options use sudo bash install.sh --help

Installation configuration

You can also configure some installation parameters using environment variables. For example:

• VALIDATOR_CONSOLE_PORT - port for validator console (default: random port in range 2000-65000)
• LITESERVER_PORT - port for liteserver (default: random port in range 2000-65000)
• VALIDATOR_PORT - port for validator (default: random port in range 2000-65000)

You can provide env file with allowed variables to installation script:

sudo bash install.sh -m <mode> --env-file /path/to/env/

Interactive CLI installer

To install MyTonCtrl using convenient interactive CLI installer, run the installation script without providing mode to it:

sudo bash install.sh [args]

You will be prompted to choose the installation mode and other options.

To run the interactive installer in dry-run mode, which will show you all the options you have selected and command that will be executed during installation without actually installing MyTonCtrl, use flag --print-env:

sudo bash install.sh --print-env

After installation, you can run MyTonCtrl console using the command:

mytonctrl

Telemetry

By default, MyTonCtrl sends validator statistics to the https://toncenter.com server. It is necessary to identify network abnormalities, as well as to quickly give feedback to developers. To disable telemetry during installation, use the -t flag:

sudo bash install.sh -m <mode> -t

To disable telemetry after installation, do the following:

MyTonCtrl> set sendTelemetry false