title | description |
---|---|
Getting the Validator Software |
This guide describes how to download and run Chainflip's validator software. |
import {Callout} from "@/components";
This guide describes how to download and run Chainflip's validator software.
It's a good practice to use a fresh node and upgrade all system dependencies before installing the validator software.
sudo apt update
sudo apt upgrade -y
We distribute our binaries as debian packages through our apt
repository. To install the packages, you need to add our repo to your apt
sources list.
Use the following commands to add Chainflip's Mainnet apt
repo to your node:
- Download Chainflip Mainnet GPG key from the Ubuntu Key Server:
gpg --keyserver hkp://keyserver.ubuntu.com --recv-keys 4E506212E4EF4E0D3E37E568596FBDCACBBCDD37
- Verify the key's authenticity:
gpg --export 4E506212E4EF4E0D3E37E568596FBDCACBBCDD37 | gpg --show-keys
```
pub rsa4096 2023-11-06 [SC]
4E506212E4EF4E0D3E37E568596FBDCACBBCDD37
uid Chainflip Labs GmbH (Releaser Master Key) <security@chainflip.io>
sub rsa4096 2023-11-06 [S] [expires: 2024-11-05]
sub rsa4096 2023-11-06 [S] [expires: 2024-11-05]
sub rsa4096 2023-11-06 [S] [expires: 2024-11-05]
```
- Add Chainflip's Mainnet Repo to
apt
sources list:
sudo mkdir -p /etc/apt/trusted.gpg.d
gpg --export 4E506212E4EF4E0D3E37E568596FBDCACBBCDD37 | sudo tee /etc/apt/trusted.gpg.d/chainflip-mainnet.gpg
echo "deb [arch=amd64 signed-by=/etc/apt/trusted.gpg.d/chainflip-mainnet.gpg] https://pkgs.chainflip.io/ubuntu/ jammy berghain" | sudo tee /etc/apt/sources.list.d/chainflip-berghain-mainnet.list
To install, run the following commands:
sudo apt update
sudo apt install -y chainflip-cli chainflip-node chainflip-engine1.2
If you are planning to run a validator using a container orchestration system like Kubernetes you can use our pre-built images on Docker Hub.
docker pull chainfliplabs/chainflip-node:berghain-1.1.1
docker pull chainfliplabs/chainflip-engine:berghain-1.1.1
docker pull chainfliplabs/chainflip-cli:berghain-1.1.1
To start the node, you would need the following options passed to the chainflip-node
binary:
chainflip-node \
--chain=/path/to/chainflip/dir/berghain.chainspec.json \
--base-path=/path/to/chainflip/dir/chaindata \
--node-key-file=/path/to/chainflip/dir/keys/node_key_file \
--validator \
--trie-cache-size=0 \
--sync=warp
If you have installed binaries through APT, the chainspec is already included in the chainflip-node
package. However, if you need the chainspec for Kubernetes deployments or other docker orchestration systems, you can download it by running:
curl https://repo.chainflip.io/chainspecs/berghain.chainspec.json -o berghain.chainspec.json