Running the node and connecting to a network

Video lessons

• Running the node and connecting to different networks

Handbook

This tutorial has been updated to work with cardano-node v.8.0.0

Public networks

The latest supported networks can be found at https://book.world.dev.cardano.org/environments.html.

Getting configuration files for the preview testnet

Create a directory for your node files:

mkdir preview
cd preview

Download the configuration files

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

cardano-node run --help

Usage: cardano-node run [--topology FILEPATH]
                          [--database-path FILEPATH]
                          [--socket-path FILEPATH]
                          [ --tracer-socket-path-accept FILEPATH
                          | --tracer-socket-path-connect FILEPATH
                          ]
                          [--byron-delegation-certificate FILEPATH]
                          [--byron-signing-key FILEPATH]
                          [--shelley-kes-key FILEPATH]
                          [--shelley-vrf-key FILEPATH]
                          [--shelley-operational-certificate FILEPATH]
                          [--bulk-credentials-file FILEPATH]
                          [--host-addr IPV4]
                          [--host-ipv6-addr IPV6]
                          [--port PORT]
                          [--config NODE-CONFIGURATION]
                          [--snapshot-interval SNAPSHOTINTERVAL]
                          [--validate-db]
                          [ --mempool-capacity-override BYTES
                          | --no-mempool-capacity-override
                          ]

Running a passive node on the preview testnet

cardano-node run --topology topology.json \
--database-path db \
--socket-path node.socket \
--port 3001 \
--config config.json 

Open a new terminal and create the CARDANO_NODE_SOCKET_PATH environment variable:

export CARDANO_NODE_SOCKET_PATH="$HOME/preview/node.socket"

Check that the node is syncing:

cardano-cli query tip --testnet-magic 2

Running a mainnet node

Create a directory for the mainnet node:

mkdir mainnet
cd mainnet

Get the configuration files:

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

cardano-node run --topology topology.json \
--database-path db \
--socket-path node.socket \
--port 3001 \
--config config.json 

On the new terminal:

export CARDANO_NODE_SOCKET_PATH="$HOME/mainnet/node.socket"