Skip to main content

Running a local TON

MyLocalTon is your personal blockchain development environment, running directly on your local computer. This comprehensive guide covers the installation, configuration, and operation of this powerful development tool.

MyLocalTon user guide​

Prerequisites​

Before starting, ensure your system meets these requirements:

  • Java version 21 or higher
  • Python 3.x (optional) for HTTP API integration
  • Windows users must install Microsoft Visual C++ Redistributable 2015+ x64

Installation process​

Windows installation steps​

  • Install Microsoft Visual C++ Redistributable 2015+ x64
  • Download the correct JAR file from the MyLocalTon Releases page based on your system architecture:
    • For x86-64 systems: MyLocalTon-x86-64.jar
    • For arm64 systems: MyLocalTon-arm64.jar

Linux/macOS installation steps​

# For x86-64 systems
wget https://github.com/neodix42/MyLocalTon/releases/latest/download/MyLocalTon-x86-64.jar 
# For arm64 systems
wget https://github.com/neodix42/MyLocalTon/releases/latest/download/MyLocalTon-arm64.jar

Building from source​

Prerequisites setup​
# Install Java Development Kit (JDK) 21
sudo apt update && sudo apt install -y openjdk-21-jdk
# Install Maven build automation tool  
sudo apt install -y maven

Verify installation:

java -version

Output should report version 21 or higher.

Clone and build​
git clone https://github.com/neodix42/MyLocalTon.git
cd MyLocalTon
mvn clean package assembly:single
Locate built artifacts​

After successful compilation, find your built artifacts in the target directory:

  • MyLocalTon-x86-64.jar for x86-64 systems
  • MyLocalTon-arm64.jar for arm64 systems

Basic operation​

Launch MyLocalTon using Java:

# For x86-64 systems  
java -jar MyLocalTon-x86-64.jar

# For arm64 systems  
java -jar MyLocalTon-arm64.jar

Command line options​

MyLocalTon accepts several parameters to customize its operation:

  • nogui: Run without graphical interface
  • ton-http-api: Enable HTTP API functionality
  • explorer: Launch explorer interface
  • ip.addr=<A.B.C.D>: Set custom IP address
  • with-validators=<N>: Specify the number of validators to start
  • custom-binaries=<absolute-path>: Use custom binaries
  • debug: Enable debug mode

For complete technical details, see the full parameter list.

MyLocalTon features a user-friendly interface: MyLocalTon UI screenshot MyLocalTon demo animation

Lite client access setup​

MyLocalTon generates permanent private/public keys for secure lite-server and validator-engine-console connections:

To establish a lite-client connection:

lite-client -a 127.0.0.1:4443 -b E7XwFSQzNkcRepUC23J2nRpASXpnsEKmyyHYV4u/FZY= -c last

To access validator-engine-console:

validator-engine-console -a 127.0.0.1:4441 -k <absolute-path>/myLocalTon/genesis/bin/certs/client -p <absolute-path>/myLocalTon/genesis/bin/certs/server.pub

Monitoring your system​

Track MyLocalTon's operation through these log files:

  • Main application logs: ./myLocalTon/MyLocalTon.log
  • Validator-engine logs: ./myLocalTon/genesis/db/log

Troubleshooting guide​

  • Run MyLocalTon in debug mode:

    java -jar MyLocalTon*.jar debug

  • Check log files for error messages

  • Verify system requirements are met

Essential information​

  1. System compatibility matrix:

    Operating SystemArchitectureSupported
    Linuxx86_64✅
    Linuxarm64/aarch64✅
    macOSx86_64✅
    macOSarm64/aarch64✅
    Windowsx86_64✅

  2. macOS users note

    If you use MacPorts instead of Homebrew, execute these commands:

    sudo mkdir -p /usr/local/opt/readline/lib
    sudo ln -s /opt/local/lib/libreadline.8.dylib /usr/local/opt/readline/lib

  3. Upgrade process:

    Currently, upgrading requires these steps:

    • Download the latest version
    • Replace the existing MyLocalTon JAR file
    • Remove the myLocalTon directory

    Developers are planning to include direct upgrade functionality in future releases.

  4. HTTP API integration:

Linux/macOS:

# Linux Installation  
sudo apt update && sudo apt install -y python3 python3-pip
pip3 install --user ton-http-api 

# macOS Installation  
brew install -q python3 
python3 -m ensurepip --upgrade
pip3 install --user ton-http-api

Windows:

# Windows Installation (Windows 10/11)

# Install Python via winget
winget install -e --id Python.Python.3

# Install the HTTP API
pip3 install -U ton-http-api

Important notice​

caution

Developers currently classify MyLocalTon as alpha software, making it unsuitable for production environments. For containerized deployment, developers recommend using the dedicated Docker repository.

Resources​

Was this article useful?