Migrating to a Different Server

No problem, one of your amazing community members has developed this guide. After you have created a new machine and finished all the steps up to and including Creating new linux users, follow this guide.

On Your New Machine

Download Binaries via APT Repo

sudo mkdir -p /etc/apt/trusted.gpg.d
gpg --export 4E506212E4EF4E0D3E37E568596FBDCACBBCDD37 | sudo tee /etc/apt/trusted.gpg.d/chainflip-mainnet.gpg

Verify the key's authenticity

gpg --export 4E506212E4EF4E0D3E37E568596FBDCACBBCDD37 | gpg --show-keys

Important: Make sure you see the following output from the terminal:

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 Repo to apt sources list

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

Installing The Packages

sudo apt-get update
sudo apt-get install -y chainflip-cli chainflip-node chainflip-engine

Adding your existing keys

sudo mkdir /etc/chainflip/keys

Note: After this you don't need to generate new Signing Keys, you can skip that phase and continue to the command below with your old Seed Secret.

Recovering Your Keys

THE_OLD_PHRASE << change to your old phrase you have backed up.

chainflip-cli generate-keys \
    --path /etc/chainflip/keys \
    --seed-phrase 'THE_OLD_PHRASE'

Please note that the Node Key cannot be recovered, a new one will be generated. This will result in a new peer id for your node.

Back Them Up & Copy Your Validator ID

sudo chmod 600 /etc/chainflip/keys/ethereum_key_file
sudo chmod 600 /etc/chainflip/keys/signing_key_file
sudo chmod 600 /etc/chainflip/keys/node_key_file
history -c

Make sure to update your config file with the IP address of the new VPS. Otherwise you'll get slashed once you start the engine on the new VPS.

Do not run two instances of your Validator at the same time. You will almost certainly be slashed. Make sure you turn off your old server before you turn on your new one.

After that make sure to stop the engine and the node on the old VPS by running:

On the Old VPS

sudo systemctl disable --now chainflip-node.service
sudo systemctl disable --now chainflip-engine.service
sudo apt purge chainflip-node
sudo apt purge chainflip-engine

On the New VPS

Setup the config file as explained in Engine Settings section.
Then start the node and engine services as explained in Start up section.

Getting Logs Common Problems