Running a Node on Xion: a step-by-step tutorial

Are you ready to dive into the world of decentralized networks? Running a node on Xion can be an exciting journey, but it requires careful setup and configuration. In this tutorial, we’ll guide you through the process of setting up and running a node on Xion, ensuring you’re equipped to participate in this vibrant ecosystem.

System specifications. Before we delve into the setup process, let’s ensure your system meets the requirements:

1. Recommended system specs:

• Operating system: Linux distributions (tested and recommended). While other operating systems may work, our support is primarily focused on Linux distributions.

2. Hardware requirements:

• Network: minimum 150 Mbps bandwidth
• CPU Cores: at least 2
• RAM: min 16 GB
• Disk: min 256 GB SSD

It’s essential to monitor your system’s resource usage as network demands may increase over time. Regular monitoring helps prevent resource depletion.

3. Commonly used ports:

Xion utilizes several TCP ports for communication. Ensure the following ports are appropriately configured:

• 26656: default port for the P2P protocol, used for node communication.
• 1317: default port for the Lite Client Daemon (LCD), providing a RESTful API.
• 26657: default port for the Tendermint RPC protocol, used for querying and sending transactions.
• 26660: default port for interacting with the database.

Caution: Only open ports 1317 and 26657 to the public if explicitly required.

Building the Xion Daemon

1. Building the xiond binary

If you prefer building the Xion Daemon binary yourself, follow these steps:

• Fetch the source code:

git clone https://github.com/burnt-labs/xion.git

• Build the binary:

cd xion make install

• Verify installation:

$ xiond version
$ xiond version --long
$ xiond --help

Ensure you’re using Go version 1.19, as compatibility issues may arise with other versions.

2. Downloading the Xion Daemon. If you prefer using pre-built versions, follow these steps:

• Download from Docker hub:

docker pull burntnetwork/xion:latest

• Run the Docker container:

$ docker run -ti burntnetwork/xion:latest /bin/bash
# xiond version
# xiond version --long
# xiond --help

3. Configuring the Xion Daemon. Now, let’s configure the Xion Daemon for network participation:

• Initialize the Daemon:

xiond init my-awesome-moniker --chain-id xion-testnet-1 --home /tmp/node

This generates the necessary configuration files.

• Configure network information:
• Download Genesis JSON:

curl https://files.xion-testnet-1.burnt.com/genesis.json -o /tmp/node/config/genesis.json -s

• Specify seed node for peer discovery:

sed -i.bak -E "s|^(seeds[[:space:]]+=[[:space:]]+).*$|\1\"$SEED_NODE\"|" /tmp/node/config/config.toml

• You can find app.toml file here:

app.toml

• You can find client.toml file here:

client.toml

• You can find config.toml file here:

config.toml

4. Joining the XION network. With the Xion Daemon configured, let’s join the network:

• Select a network: currently, xion-testnet-1 is available.

xion-testnet-1

• Hosts and endpoints: use provided endpoints for interaction with the network.
• Download Genesis JSON: ensure you have the latest Genesis JSON for network parameters.
• Specify seed node: configure your node to discover peers.
• Synchronize the chain: use node snapshot or state sync for faster synchronization.

Here you can find more info about Nodes & Validators:

Run a Node

Congratulations! You’re now ready to participate in the Xion Network. Stay engaged with the community and explore the vast possibilities of decentralized networks. Happy node running!

How to track XION?

• DISCORD
• TWITTER
• BLOG

Prepared by niniao