ton-docker-ctrl

Tested operating systems:

• Ubuntu 20.04
• Ubuntu 22.04
• Ubuntu 24.04
• Debian 11
• Debian 12

Prerequisites

To run, you need docker-ce, docker-buildx-plugin, docker-compose-plugin:

• Install Docker Engine on Ubuntu
• Install Docker Engine on Debian

Build environment variables (are configured in the .env file):

• GLOBAL_CONFIG_URL - URL of the TON blockchain configuration (default: Mainnet)
• MYTONCTRL_VERSION - MyTonCtrl build branch (default master)
• TELEMETRY - Enable/Disable telemetry (default true)
• IGNORE_MINIMAL_REQS - Ignore hardware requirements (default true)
• MODE - Install MyTonCtrl with specified mode (validator or liteserver, default validator)
• DUMP - Use pre-packaged dump. Reduces duration of initial synchronization, but it takes time to download the dump. You can view the download status in the logs docker compose logs -f. (default false).

Run MyTonCtrl v2 in docker:

• Run docker run -d --name ton-node -v /mnt/data/ton-work1:/var/ton-work -it ghcr.io/ton-blockchain/ton-docker-ctrl:latest

Build Docker image from sources and run MyTonCtrl v2:

• Clone: git clone https://github.com/ton-blockchain/ton-docker-ctrl.git && cd ./ton-docker-ctrl
• Run: docker compose up --build -d
• Connect docker compose exec -it node bash -c "mytonctrl"

Upgrade MyTonCtrl docker image from repository:

• Pull docker image: docker pull docker pull ghcr.io/ton-blockchain/ton-docker-ctrl:latest

Upgrade MyTonCtrl docker images from sources:

• Build new image: docker compose build ton-node
• Run new version: docker compose up -d

Migrate non-Docker fullnode or validator to a dockerized MyTonCtrl v2

Specify paths to TON binaries and sources, as well as to TON work directory, but most importantly to MyTonCtrl settings and wallets.

docker run -d --name ton-node --restart always \
-v /mnt/data/ton-work:/var/ton-work \
-v /usr/bin/ton:/usr/bin/ton \
-v /usr/src/ton:/usr/src/ton \
-v /home/<USER>/.local/share:/usr/local/bin \
ghcr.io/ton-blockchain/ton-docker-ctrl:latest

Read the logs

docker logs ton-node

Get inside the container and run MyTonCtrl

docker exec -ti ton-node bash