# Run a local Testnet

# Build the node server

Before you start your journey as an IoTeX developer, you need a IoTeX Gateway node to serve as an endpoint, that you can use to interact with the blockchain. While IoTeX provides official gateway nodes both to interact with Mainnet and Testenet, in this guide we will configure our own local Testnet, that will also include pre-generated accounts with some balance to start with.

WARNING

To configure a single-node blockchain locally on your computer, you will need git and golang installed: find more isnstructions on GitHub (opens new window).

Clone and build the IoTeX Full-Node code (iotex-core)

git clone https://github.com/iotexproject/iotex-core.git
cd iotex-core
make
1
2
3

# Add a test account with initial balance

Now that the node executable is built in the .bin/ directory, the last step is to add an initial test account preloaded with IOTX tokens. We will use our dev-acc account:

$ ioctl account list

io1a8r9fvu6e3vthfaqvnxlhc6eavsm6t8a2cwtud - dev-acc
1
2
3

edit the genesis file ./config/standalone-genesis.yaml and add this account to the initBalances section:

account:
  initBalances:
    # overwrite with your test address
    io1a8r9fvu6e3vthfaqvnxlhc6eavsm6t8a2cwtud: "100000000000000000000000000000000000"
1
2
3
4

we can now start our testnet using STANDALONE mode to simulate a full blockchain in a single node

make run
1