# Setting up a local blockchain using MyLocalTon (https://docs-i0yym09dy-ton-core-docs.vercel.app/llms/ecosystem/nodes/cpp/setup-mylocalton/content.md)



MyLocalTon packages validator nodes, a lite-server, explorer, and optional HTTP API into a single JAR so you can prototype locally without touching mainnet. Use it for integration tests, smart-contract dry runs, and demos before deploying to public networks.

## Prerequisites [#prerequisites]

* Java Development Kit (JDK) 21 or newer in your `PATH`.
* Python 3.9-3.12 if you plan to enable the optional HTTP API bridge.
* On Windows, install the Microsoft Visual C++ 2015+ x64 Redistributable.
* Allocate at least 4 CPU cores, 16 GB RAM, and 20 GB of free disk space for smooth operation.

## Download and install [#download-and-install]

### Windows [#windows]

1. Install the Visual C++ Redistributable.
2. Download the JAR that matches your architecture from the [MyLocalTon releases](https://github.com/neodix42/MyLocalTon/releases).
   * `MyLocalTon-x86-64.jar` for x86-64 systems.
   * `MyLocalTon-arm64.jar` for ARM64 systems.

### macOS and Linux [#macos-and-linux]

```bash
# x86-64
wget https://github.com/neodix42/MyLocalTon/releases/latest/download/MyLocalTon-x86-64.jar
# ARM64
wget https://github.com/neodix42/MyLocalTon/releases/latest/download/MyLocalTon-arm64.jar
```

### Build from source [#build-from-source]

```bash
sudo apt install openjdk-21-jdk ant maven
git clone https://github.com/neodix42/MyLocalTon.git
cd MyLocalTon
mvn clean package assembly:single
```

The JAR with all dependencies appears under `target/` when the build finishes.

## Launch the local network [#launch-the-local-network]

```bash
java -jar MyLocalTon-x86-64.jar
```

Useful arguments:

| Flag                     | Description                                                   |
| ------------------------ | ------------------------------------------------------------- |
| `nogui`                  | Run in headless mode without the Swing interface.             |
| `with-validators=<N>`    | Start `N` validator instances (default: 1).                   |
| `explorer`               | Launch the bundled block explorer.                            |
| `ton-http-api`           | Start the HTTP API bridge (requires Python + `ton-http-api`). |
| `custom-binaries=<PATH>` | Load TON binaries from a custom directory.                    |
| `ip.addr.X.X`            | Bind services to a specific local IP.                         |
| `debug`                  | Increase log verbosity for troubleshooting.                   |

The first run creates the `myLocalTon/` workspace alongside the JAR. Validators, liteserver certificates, and logs live in this directory.

## Connect CLI tools [#connect-cli-tools]

MyLocalTon prints the lite-server public key during startup and stores certificates in `./myLocalTon/genesis/bin/certs/`.

```bash
lite-client -a 127.0.0.1:4443 -b E7XwFSQzNkcRepUC23J2nRpASXpnsEKmyyHYV4u/FZY= -c last
validator-engine-console \
  -a 127.0.0.1:4441 \
  -k $(pwd)/myLocalTon/genesis/bin/certs/client \
  -p $(pwd)/myLocalTon/genesis/bin/certs/server.pub
```

## Enable the HTTP API bridge [#enable-the-http-api-bridge]

<Callout type="caution">
  On Windows, install 

  [OpenSSL v1.1.1](https://slproweb.com/products/Win32OpenSSL.html)

   first
</Callout>

Install Python dependencies on the host system, then restart MyLocalTon with the `ton-http-api` flag or enable the "Start TON Center" toggle in UI.

```bash
# Linux
sudo apt install -y python3 python3-pip
pip3 install --user ton-http-api

# macOS (Homebrew)
brew install python3
python3 -m ensurepip --upgrade
pip3 install --user ton-http-api

# Windows
py -3 -m ensurepip --upgrade
py -3 -m pip install --user ton-http-api
```

The bridge exposes REST endpoints that mirror the lite-server APIs for tooling that cannot speak the native ADNL protocol.

## Monitor and maintain [#monitor-and-maintain]

* Tail `myLocalTon/MyLocalTon.log` for application-level events.
* Validator logs reside in `myLocalTon/genesis/db/log`.
* Re-run with `debug` when reproducing issues.
* Upgrade by downloading the latest JAR, replacing the existing file, and deleting the `myLocalTon` directory so the genesis state regenerates.

## Troubleshooting tips [#troubleshooting-tips]

| Symptom            | Resolution                                                                                                             |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| JAR fails to start | Verify Java 21+ is installed and the file is not quarantined by the OS (macOS: `xattr -d com.apple.quarantine <JAR>`). |
| HTTP API errors    | Ensure Python 3.9-3.12 and `ton-http-api` are installed.                                                               |
| Need a clean reset | Stop the process, delete the `myLocalTon` folder, and restart the JAR to regenerate the network.                       |

## Where to go next [#where-to-go-next]

* Graduate to production setups with [Setting up a node using MyTonCtrl](/llms/ecosystem/nodes/cpp/setup-mytonctrl/content.md).
* Explore node roles and responsibilities in the [node overview](/llms/ecosystem/nodes/overview/content.md).