Skip to content

Latest commit

 

History

History
63 lines (47 loc) · 2.33 KB

README.md

File metadata and controls

63 lines (47 loc) · 2.33 KB
Raw

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:

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