Chiliz Testnet Node Setup

Full Chiliz Spicy Testnet node setup automated with Ansible, running on a QEMU/KVM Ubuntu VM via Vagrant, with Prometheus + Grafana monitoring and public endpoint exposure via Nginx + ngrok.

Prerequisites

On your host machine:

• QEMU/KVM + libvirt
• Vagrant + vagrant-libvirt plugin
• Ansible
• ngrok account + authtoken

Setup

Clone the repo and enter the directory:

git clone https://github.com/AxolotlHere/chiliz-node-files.git
cd chiliz-node

Create your .env file:

echo "NGROK_TOKEN=your_ngrok_token_here" > .env

Start the VM:

vagrant up --provider=libvirt

Running the Playbooks

Run in this order:

1. Node setup — installs dependencies, builds geth from source, starts the node:

ansible-playbook -i inventory chiliz-node-setup.yml

2. Prometheus — sets up metrics collection:

ansible-playbook -i inventory prometheus-setup.yml

3. Grafana — sets up the monitoring dashboard:

ansible-playbook -i inventory grafana-setup.yml

4. Nginx — sets up the reverse proxy:

ansible-playbook -i inventory nginx-setup.yml

5. ngrok — exposes endpoints publicly:

./exec-ngrok.sh

Endpoints

Once everything is running, get your public ngrok URL:

vagrant ssh
curl http://localhost:4040/api/tunnels | python3 -m json.tool | grep public_url

Then hit the following routes on that URL:

• /rpc — Chiliz node RPC
• /metrics — node metrics
• /grafana — Grafana dashboard (additional feature outside of the said bonus)

Grafana Login

username: admin
password: admin

Verify Node is Syncing

vagrant ssh
sudo journalctl -u chiliz -f

Check Service Status

vagrant ssh
sudo systemctl status chiliz
sudo systemctl status prometheus
sudo systemctl status grafana-server
sudo systemctl status nginx
sudo systemctl status ngrok