Configuring and Running the Node

This page will work for both block producing nodes and relays. Read the instructions carefully as the firewall configurations differ for bps and relays.

First, lets create a directory structure to house things like our node and configuration files.

cd
mkdir -p preprodnet/{node,config,socket,db,scripts,bin,logs}

Let's add our bin and socket directorues to our PATH.

First, open .bashrc with nano

nano ~/.bashrc

Then, add the following lines to the bottom of the file and save with ctrl+o and exit with ctrl+x.

export PATH=/home/preprod/preprodnet/bin:$PATH
export CARDANO_NODE_SOCKET_PATH="/home/preprod/preprodnet/socket/node.socket"

After saving, we will confirm the changes.

cd
. .bashrc
echo $PATH

You should see /home/preprod/preprodnet/bin added to the output.

Because of time constraints, we will be downloading a precompiled binary (Thanks to the Armada Alliance!) rather than building on an underpowered SBC. Let's grab the node for preview (cardano-node version 8.7.1-pre with ghc-9.6.3 at this time)

cd ~/preprodnet/node
wget -O cardano-8_7_1_pre-aarch64-static-musl-ghc_963.zip https://github.com/armada-alliance/cardano-node-binaries/blob/main/static-binaries/cardano-8_7_1_pre-aarch64-static-musl-ghc_963.zip?raw=true
unzip cardano-8_7_1_pre-aarch64-static-musl-ghc_963.zip
cd cardano-8_7_1_pre-aarch64-static-musl-ghc_963
cp cardano-node ~/preprodnet/bin/
cp cardano-cli ~/preprodnet/bin/

Confirm that the node and cli binaries are extracted to the correct location

cardano-cli --version

Your output should look something like this.

cardano-node --version

Again...

---

The following is for your relay node only.

Create a firewall rule for your relay. Please change the command to match your relay port.

sudo ufw allow <your relay port>/tcp

---

The following is for your block producing node only.

For your block producer, instead of allowing traffic from anywhere on your node's port, you are going to only allow traffic from your relay to that port.

sudo ufw allow from <your internal relay IP> proto tcp to any port <your block producer port>

---

Reload the firewall to make changes active.

sudo ufw reload

Next, lets grab some configuration files for Preprod

cd ~/preprodnet/config
wget https://book.world.dev.cardano.org/environments/preprod/config.json
wget https://book.world.dev.cardano.org/environments/preprod/topology.json
wget https://book.world.dev.cardano.org/environments/preprod/byron-genesis.json
wget https://book.world.dev.cardano.org/environments/preprod/shelley-genesis.json
wget https://book.world.dev.cardano.org/environments/preprod/alonzo-genesis.json
wget https://book.world.dev.cardano.org/environments/preprod/conway-genesis.json

Let's make sure we've done everything correctly so far and run the node.

cardano-node run --topology ~/preprodnet/config/topology.json \
--database-path ~/preprodnet/db \
--socket-path ~/preprodnet/socket/node.socket \
--port <your relay port> \
--config ~/preprodnet/config/config.json

If all is well you'll see output like this.

Press ctrl+c to stop the node for now.