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"