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).
Recommended Cloud Providers
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
orn2d-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
orecs.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.
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:
- Ubuntu
- Debian
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
sudo bash install.sh -m full
wget https://raw.githubusercontent.com/ton-blockchain/mytonctrl/master/scripts/install.sh
su root -c 'bash install.sh -m full'
2. Conduct an Operability Test:
Run mytonctrl console from the local user account used for installation in step 1:
mytonctrl
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:
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:
Become a Validator
Complete the previous installation steps.
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
commandaw
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).
Tips & Tricks
- You can use
help
to get a list of available commands:
- To check mytoncrl logs, open
~/.local/share/mytoncore/mytoncore.log
for a local user or/usr/local/bin/mytoncore/mytoncore.log
for Root.
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.