Skip to main content

Running a Full Node

To install and manage your own node, use the MyTonCtrl open source tool developed by TON Foundation. The majority of TON Nodes are reliable and tested by mytonctrl.

MyTonCtrl is a console application that serves as a convenient wrapper for fift, lite-client, and validator-engine-console. It has been specifically developed to streamline wallet, domain, and validator management tasks on the Linux operating system.

Hardware requirements​

  • at least 8 cores CPU
  • at least 64 GB RAM
  • at least 512 GB NVMe SSD (25k+ IOPS)
  • 1 Gbit/s network connectivity
  • public IP address (fixed IP address)

You need a machine with a fixed IP address and a high-bandwidth network connection to run a TON Blockchain Full Node. Typically you'll need a sufficiently powerful server in a data center with good network connectivity, using at least a 1 Gbit/s connection to reliably accommodate peak loads (the average load is expected to be approximately 100 Mbit/s).

The following providers are recommended by the TON Foundation.

AWS​

  • Instance Type: m5.4xlarge
  • CPU: 16 vCPUs
  • RAM: 64 GB
  • Storage: Provisioned IOPS 512 GB SSD volume. (io1)
  • Network: Up to 10 Gbps
  • Public IP: Associate an Elastic IP for a fixed IP address.

GCP (Google Cloud Platform)​

  • Machine Type: n2-highmem-8 or n2d-highmem-8
  • CPU: 8 vCPUs
  • RAM: 64 GB
  • Storage: Attach a 512 GB NVMe SSD persistent disk.
  • Network: 16 Gbps
  • Public IP: Reserve a static external IP address.

Alibaba Cloud​

  • Instance Type: ecs.g6.4xlarge or ecs.c6.4xlarge
  • CPU: 16 vCPUs
  • RAM: 64 GB
  • Storage: Provision a 512 GB NVMe SSD disk.
  • Network: Up to 10 Gbps
  • Public IP: Bind an Elastic IP for a fixed IP address.

Tencent Cloud​

  • Instance Type: M5.2XLARGE
  • CPU: 8 vCPUs
  • RAM: 64 GB
  • Storage: Provision a 512 GB NVMe SSD cloud disk.
  • Network: Up to 10 Gbps
  • Public IP: Associate an Elastic IP for a fixed IP address.

Vultr​

  • Instance Type: bare metal Intel E-2388G
  • CPU: 8 Cores / 16 Threads
  • RAM: 128 GB
  • Storage: 1.92TB NVMe SSD
  • Network: 10 Gbps
  • Public IP: Fixed IP address included with instance.

DigitalOcean​

  • Instance Type: general purpose premium Intel
  • CPU: 16 vCPUs
  • RAM: 64 GB
  • Storage: 480GB (Chose 2xSSD)
  • Network: 10 Gbps
  • Public IP: Fixed IP address included with instance.

Latitude​

  • Instance Type: c3.medium.x86
  • CPU: 16 Cores / 32 Threads
  • RAM: 128 GB
  • Storage: 1.9TB
  • Network: 10 Gbps
  • Public IP: Fixed IP address included with instance.
info

Note: Prices, configurations, and availability may vary. Always check the respective cloud provider's official documentation and pricing pages before making a decision.

Installation​

How to run the Node? (video)​

Please, check this video step-by-step tutorial to start promtly:

Step-by-step instructions​

1. Install the mytonctrl tool​

Download and run the installation script. Choose your Linux distributive:

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

2. Conduct an Operability Test:​

  1. Run mytonctrl console from the local user account used for installation in step 1:

    mytonctrl

  2. Check the mytonctrl statuses using the status command:

    status

The following statuses should be displayed:

  • mytoncore status: Should be in green.
  • Local validator status: Should also be in green.
  • Local validator out of sync: Initially, a large number is displayed. As soon as the newly created validator connects with other validators, the number will be around 250k. As synchronization progresses, this number decreases. When it falls below 20, the validator is synchronized.

Example of the status command output:

status

3. View the List of Available Wallets​

Check out the list of available wallets in the mytonctrl console using the wl command:

wl

During the installation of mytonctrl, the validator_wallet_001 wallet is created:

wallet list

Become a Validator​

  1. Complete the previous installation steps.

  2. Send the Required Number of Coins to the Wallet and Activate It

To determine the minimum amount of coins required to participate in one election round, head to tonmon.xyz > Participant stakes.

  • Use the vas command to display the history of transfers:

    vas

  • Activate the wallet using the aw command

    aw

account history

2. Your Validator is Now Ready​

mytoncore will automatically join the elections. It divides the wallet balance into two parts and uses them as a stake to participate in the elections. You can also manually set the stake size:

set stake 50000

set stake 50000 — this sets the stake size to 50k coins. If the bet is accepted and our node becomes a validator, the bet can only be withdrawn in the second election (according to the rules of the electorate).

setting stake

Tips & Tricks​

  • You can use help to get a list of available commands:

help command

  • To check mytoncrl logs, open ~/.local/share/mytoncore/mytoncore.log for a local user or /usr/local/bin/mytoncore/mytoncore.log for Root.

logs

FAQ​

This section contains answers to the most frequently asked questions about running a full node.

Error 651​

Error: 651 indicates that your node is unable to locate another node within the TON Blockchain.

Sometimes, this process can take up to 24 hours. However, if you've been receiving this error for several days, that means that your node cannot synchronize via current network connection.

Validator console is not settings​

If you see this error this means that you run mytonctrl not from the user you've installed it.

Please, run mytonctrl from the user you've installed it.