Cover photo

Allora node install guide

System Requirements

  • OS: Ubuntu 20.04 LTS or newer

  • CPU: 4 cores

  • RAM: minimum 8 GB, 16 GB recommended

  • Storage: SSD with at least 100 GB free space

  • Network: Stable internet connection, minimum 10 Mbps

Preliminary Setup

  1. Update the system:

sudo apt update && sudo apt upgrade -y
  1. Install necessary dependencies:

sudo apt install -y git curl jq build-essential
  1. Install Docker and Docker Compose:

sudo apt install -y docker.io docker-compose
sudo systemctl enable docker
sudo systemctl start docker
sudo usermod -aG docker $USER

Restart your terminal session after this step.

Installing Allora Node

  1. Clone the repository:

git clone https://github.com/allora-network/allora-chain.git
cd allora-chain
  1. Create a configuration file:

cat << EOF > config.yaml
chain-id: "allora-testnet-1"
rpc-addr: "tcp://0.0.0.0:26657"
grpc-addr: "0.0.0.0:9090"
api-addr: "tcp://0.0.0.0:1317"
p2p-addr: "tcp://0.0.0.0:26656"
EOF
  1. Create a docker-compose.yml file:

cat << EOF > docker-compose.yml
version: '3'
services:
  node:
    image: ghcr.io/allora-network/allora-chain:v0.5.0
    volumes:
      - ./data:/root/.allora
      - ./config.yaml:/root/.allora/config/config.yaml
    ports:
      - "26656:26656"
      - "26657:26657"
      - "1317:1317"
      - "9090:9090"
    command: start --home /root/.allora
EOF
  1. Start the node:

docker-compose up -d

Verifying Node Operation

  1. Check the node status:

curl -s http://localhost:26657/status | jq .result.sync_info
  1. View logs:

docker-compose logs -f

Managing the Node

  • Stop the node:

docker-compose down
  • Restart the node:

docker-compose restart
  • Update the node:

docker-compose pull
docker-compose up -d

Additional Configuration

To configure P2P connections, edit config.yaml:

p2p:
  laddr: "tcp://0.0.0.0:26656"
  seeds: "seed1.example.com:26656,seed2.example.com:26656"
  persistent_peers: "peer1.example.com:26656,peer2.example.com:26656"