How to Run an Avail node

How to run an Avail node

There are two main ways of running an Avail node:

  1. By running a pre-built binary.
  2. By building from source
  3. By running a pre-built image using Docker
  1. Go to the Avail node GitHub releases page (opens in a new tab). There you will see a lot of pre-built binaries for each version of the Avail node.

  2. Please download the binary suitable from your system, of the latest recommended version, which as of now is 2.2.4.1. You can do this using the GUI or by running the following command in your terminal:

curl -L -O https://github.com/availproject/avail/releases/download/v2.2.4.1/<YOUR-SYSTEM-SPECIFIC-BINARY>.tar.gz
  1. Extract the downloaded file by opening a terminal in the location of the downloaded file and using the following command:
tar -xzvf <YOUR-SYSTEM-SPECIFIC-BINARY>.tar.gz

Your terminal should now look something like this:


Extracted Avail node binary

  • The file in red is what we downloaded to our system.
  • The file in green is the extracted binary.
  1. Once extracted, you will see a pre-built, executable binary named avail-node in the same directory. You can run this binary using the following command:
./avail-node --name a-random-name --chain mainnet -d ./output
  1. Your terminal output should look something like this:
2024-04-29 07:48:22 Avail Node    
2024-04-29 07:48:22 ✌️  version 2.1.1-8608dc47f00    
2024-04-29 07:48:22 ❀️  by Avail Project <info@availproject.org>, 2017-2024    
2024-04-29 07:48:22 πŸ“‹ Chain specification: Avail Turing Network    
2024-04-29 07:48:22 🏷  Node name: possible-point-3102    
2024-04-29 07:48:22 πŸ‘€ Role: FULL    
2024-04-29 07:48:22 πŸ’Ύ Database: ParityDb at ./output/chains/avail_turing_network/paritydb/full    
2024-04-29 07:48:27 πŸ”¨ Initializing Genesis block/state (state: 0x5603…9c01, header-hash: 0xd3d2…8b70)    
2024-04-29 07:48:27 πŸ‘΄ Loading GRANDPA authority set from genesis on what appears to be first startup.    
2024-04-29 07:48:29 πŸ‘Ά Creating empty BABE epoch changes on what appears to be first startup.    
2024-04-29 07:48:29 🏷  Local node identity is: 12D3KooWELgzaRZqsHNyUodhZZF7A1ydsRpgLsY7fojDegKni4YF    
2024-04-29 07:48:29 Prometheus metrics extended with avail metrics    
2024-04-29 07:48:29 πŸ’» Operating system: linux    
2024-04-29 07:48:29 πŸ’» CPU architecture: x86_64    
2024-04-29 07:48:29 πŸ’» Target environment: gnu    
2024-04-29 07:48:29 πŸ’» CPU: DO-Premium-Intel    
2024-04-29 07:48:29 πŸ’» CPU cores: 4    
2024-04-29 07:48:29 πŸ’» Memory: 7937MB    
2024-04-29 07:48:29 πŸ’» Kernel: 5.15.0-105-generic    
2024-04-29 07:48:29 πŸ’» Linux distribution: Ubuntu 22.04.4 LTS    
2024-04-29 07:48:29 πŸ’» Virtual machine: yes    
2024-04-29 07:48:29 πŸ“¦ Highest known block at #0    
2024-04-29 07:48:29 Running JSON-RPC server: addr=127.0.0.1:9944, allowed origins=["http://localhost:*", "http://127.0.0.1:*", "https://localhost:*", "https://127.0.0.1:*", "https://polkadot.js.org"]    
2024-04-29 07:48:29 🏁 CPU score: 950.72 MiBs    
2024-04-29 07:48:29 🏁 Memory score: 4.02 GiBs    
2024-04-29 07:48:29 🏁 Disk score (seq. writes): 845.72 MiBs    
2024-04-29 07:48:29 🏁 Disk score (rand. writes): 338.52 MiBs    
2024-04-29 07:48:29 〽️ Prometheus exporter started at 127.0.0.1:9615    
2024-04-29 07:48:30 πŸ” Discovered new external address for our node: /ip4/139.59.94.121/tcp/30333/ws/p2p/12D3KooWELgzaRZqsHNyUodhZZF7A1ydsRpgLsY7fojDegKni4YF    
2024-04-29 07:48:34 βš™οΈ  Syncing, target=#137399 (9 peers), best: #1000 (0x9e8f…55ab), finalized #512 (0x0a9a…875a), ⬇ 316.3kiB/s ⬆ 14.2kiB/s    
2024-04-29 07:48:39 βš™οΈ  Syncing 235.4 bps, target=#137399 (9 peers), best: #2177 (0x5828…e9da), finalized #2048 (0x2f65…3b2e), ⬇ 113.3kiB/s ⬆ 5.5kiB/s    
2024-04-29 07:48:43 [3097] πŸ’Έ generated 8 npos targets    
2024-04-29 07:48:43 [3097] πŸ’Έ generated 8 npos voters, 8 from validators and 0 nominators    
2024-04-29 07:48:43 [#3097] πŸ—³  creating a snapshot with metadata SolutionOrSnapshotSize { voters: 8, targets: 8 }    
2024-04-29 07:48:43 [#3097] πŸ—³  Starting phase Signed, round 1.    
2024-04-29 07:48:44 [#3277] πŸ—³  Starting phase Unsigned((true, 3277)), round 1.    
2024-04-29 07:48:44 [#3278] πŸ—³  queued unsigned solution with score ElectionScore { minimal_stake: 184467440819699, sum_stake: 184467440819699, sum_stake_squared: 34028236722569152873026450601 }    
2024-04-29 07:48:44 βš™οΈ  Syncing 236.0 bps, target=#137400 (10 peers), best: #3357 (0x0c50…7d21), finalized #3072 (0x2803…c15b), ⬇ 244.0kiB/s ⬆ 20.2kiB/s    
2024-04-29 07:48:44 [#3457] πŸ—³  Starting phase Off, round 2.    
2024-04-29 07:48:44 [3457] πŸ’Έ new validator set of size 1 has been processed for era 1    
2024-04-29 07:48:49 βš™οΈ  Syncing 206.2 bps, target=#137400 (10 peers), best: #4388 (0x2d3d…6b93), finalized #4177 (0x58f8…9518), ⬇ 261.5kiB/s ⬆ 11.6kiB/s    
2024-04-29 07:48:54 βš™οΈ  Syncing 232.0 bps, target=#137400 (10 peers), best: #5548 (0x1aef…1c46), finalized #5120 (0x274f…e5d7), ⬇ 122.7kiB/s ⬆ 6.9kiB/s    
2024-04-29 07:48:59 βš™οΈ  Syncing 118.2 bps, target=#137400 (10 peers), best: #6139 (0x9e52…af00), finalized #5632 (0x5297…a001), ⬇ 66.5kiB/s ⬆ 4.9kiB/s    
2024-04-29 07:49:04 βš™οΈ  Syncing 185.7 bps, target=#137401 (10 peers), best: #7068 (0x911d…666a), finalized #6656 (0xdd79…2e5e), ⬇ 80.7kiB/s ⬆ 1.5kiB/s    
2024-04-29 07:49:05 [7417] πŸ’Έ generated 9 npos targets    
2024-04-29 07:49:05 [7417] πŸ’Έ generated 9 npos voters, 9 from validators and 0 nominators    
2024-04-29 07:49:05 [#7417] πŸ—³  creating a snapshot with metadata SolutionOrSnapshotSize { voters: 9, targets: 9 }    
2024-04-29 07:49:05 [#7417] πŸ—³  Starting phase Signed, round 2.    
2024-04-29 07:49:06 [#7597] πŸ—³  Starting phase Unsigned((true, 7597)), round 2.    
2024-04-29 07:49:06 [#7598] πŸ—³  queued unsigned solution with score ElectionScore { minimal_stake: 184447246591607, sum_stake: 1475577972732856, sum_stake_squared: 272166294201800640629142739592 }    
2024-04-29 07:49:07 [#7777] πŸ—³  Finalized election round with compute Unsigned.    
2024-04-29 07:49:07 [#7777] πŸ—³  Starting phase Off, round 3.    
2024-04-29 07:49:07 [7777] πŸ’Έ new validator set of size 8 has been processed for era 2    
2024-04-29 07:49:09 βš™οΈ  Syncing 206.2 bps, target=#137401 (10 peers), best: #8099 (0x559a…9c2e), finalized #7680 (0x84b6…abc0), ⬇ 103.9kiB/s ⬆ 0.9kiB/s    
2024-04-29 07:49:14 βš™οΈ  Syncing 204.4 bps, target=#137401 (10 peers), best: #9121 (0xf95e…5a17), finalized #8704 (0x6e49…33cd), ⬇ 98.0kiB/s ⬆ 1.5kiB/s

Your node will also appear on the Avail Telemetry site (opens in a new tab), listed under the "Node name" from the node command output. Be sure to select the appropriate network tab at the top to view your node's status.

Additional configs

The Avail node is a highly customizable piece of software. You can fetch a list of supported commands and flags using:

./avail-node --help

Alternatively, you can check out this notion page (opens in a new tab).

Please note that the notion page may not always be updated. The best way to reliably get the latest config options will be ./avail-node --help.