TON Node Upgrade 2025.11

For validators running on Ubuntu 22.04 and 24.04 and using MyTonCtrl the upgrade process hasn't changed:

mytonctrl>upgrade master

The one who does not use MyTonCtrl, refer to your regular TON upgrade guide, but make sure to execute following commands before you start:

 git submodule sync --recursive

git submodule update

Below is the guide on how to migrate TON node on Ubuntu 20.04 to Ubuntu 22.04.5 LTS.

1. Prepare

sudo apt update -y

sudo apt upgrade -y

2. Reboot

sudo shutdown -r now

3. Upgrade

sudo do-release-upgrade

4. Reboot again

sudo shutdown -r now

5. Check if you don't have focal repositories listed

grep -R '^deb' /etc/apt/sources.list /etc/apt/sources.list.d/ | grep -E 'focal|jammy'

6. Remove or update if there are any

sudo sed -i 's/focal/jammy/g' /etc/apt/sources.list

sudo sed -i 's/focal/jammy/g' /etc/apt/sources.list.d/*.list 2>/dev/null || true

7. Update MyTonCtrl

cd /usr/src/mytonctrl

sudo pip install .

8. Install clang-16

wget https://apt.llvm.org/llvm.sh

sudo chmod +x llvm.sh

sudo ./llvm.sh 16 clang

9. If step 7. or 8. fails with any error, you need to update GCC and its dependencies

sudo apt remove --allow-remove-essential gcc-11-base -y

sudo apt install -y \

 gcc-11-base=11.4.0-1ubuntu1~22.04.2 \

 libstdc++-11-dev=11.4.0-1ubuntu1~22.04.2 \

 libgcc-11-dev=11.4.0-1ubuntu1~22.04.2 \

 libobjc-11-dev=11.4.0-1ubuntu1~22.04.2 \

 libasan6=11.4.0-1ubuntu1~22.04.2 \

 libtsan0=11.4.0-1ubuntu1~22.04.2

10. Repeat step 7. and 8.

11. Make clang 16 default

sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-16 160

sudo update-alternatives --install /usr/bin/clang++ clang++ /usr/bin/clang++-16 160

12. Upgrade TON binaries

mytonctrl>upgrade master