Install Relayer

Begin with neccesary software install

sudo apt update && sudo apt upgrade -y &&
sudo apt install libssl-dev libudev-dev pkg-config zlib1g-dev llvm clang cmake make libprotobuf-dev protobuf-compiler -y

Install Rust

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env

Clone relayer repo

cd $HOME && git clone https://github.com/projectxsol/lite-relayer.git

Build binary

cd lite-relayer && 
git fetch &&
git submodule update --init --recursive &&
cargo build --release --bin transaction-relayer

Make working dirs and generate keys

mkdir -p $HOME/.relayer-config &&
solana-keygen new -o $HOME/.relayer-config/relayer.json &&
openssl genrsa -out $HOME/.relayer-config/auth 1024 &&
openssl rsa -in $HOME/.relayer-config/auth -pubout -out $HOME/.relayer-config/auth.pub

Create relayer.service file

Copy and paste your desired location into terminal:

US:

X_BLOCK_ENGINE=http://ny.block-engine.com:11227

EU:

X_BLOCK_ENGINE=http://de.block-engine.com:11227

You can check that variable is passed with command:

echo $X_BLOCK_ENGINE

If output is blank try to paste X_BLOCK_ENGINE variable once again.

After succesfully enter location paste full text into terminal to create relayer.service:

tee $HOME/relayer.service > /dev/null <<EOF
[Unit]
Description=X Transaction Relayer
Requires=network-online.target
After=network-online.target
[Service]
User=$USER
Type=simple
ExecStart=$HOME/lite-relayer/target/release/transaction-relayer \
--keypair-path $HOME/.relayer-config/relayer.json \
--signing-key-pem-path $HOME/.relayer-config/auth \
--verifying-key-pem-path $HOME/.relayer-config/auth.pub \
--webserver-bind-addr 127.0.0.1:5050 \
--grpc-bind-ip 127.0.0.1 \
--x-block-engine-url $X_BLOCK_ENGINE
RestartSec=10
Restart=on-failure
[Install]
WantedBy=multi-user.target
EOF

(OPTIONAL) If you want to not write logs into journal:

--x-block-engine-url $X_BLOCK_ENGINE # After this line

Add following lines to service to log into file:

StandardOutput=append:/var/log/transaction-relayer.log
StandardError=append:/var/log/transaction-relayer.log

Add following lines to not write logs:

StandardOutput=null
StandardError=null
LogRateLimitIntervalSec=0
LogRateLimitBurst=0

Move service file to systemd folder

sudo mv $HOME/relayer.service /etc/systemd/system/

Check that your validator settings are up to date

Shreds setup

Put into solana.service

DE:

--shred-receiver-address "160.202.131.181:1002"

NY:

--shred-receiver-address "185.209.178.175:1002"

Hot change

DE:

agave-validator --ledger /PATH/TO/LEDGER set-shred-receiver-address --shred-receiver-address "160.202.131.181:1002"

NY:

agave-validator --ledger /PATH/TO/LEDGER set-shred-receiver-address --shred-receiver-address "185.209.178.175:1002"

Restart services

sudo systemctl daemon-reload
sudo systemctl enable relayer.service
sudo systemctl restart relayer

Only one relayer should be running at same time.

Open ports in your firewall if you are using one. Ports 11228 and 11229 as default ports for relayer should be opened for UDP traffic. There is example for ufw:

sudo ufw allow 11228,11229/udp

You can also connect your validator to relayer without validator restart with hot-swap command (fill in your own path to ledger before paste to terminal)

solana-validator --ledger /PATH/TO/LEDGER set-relayer-config --relayer-url http://127.0.0.1:11226

This command have no output so check everything correct before hot-swap

(DEFAULT) How to check relayer logs

journalctl -n 100 -f -u relayer

Write logs to file

journalctl -u relayer.service --since "12 hours ago" > relayer_logs.txt