0_core_relay.md

Configure topology files for block-producing and relay nodes.

Before you start your nodes, you need to prepare the topology files.

Configure the block-producing node

Make the block-producing node to "talk" only to YOUR relay node. Do not forget to configure your firewall also:

nano topology.json

{
  "Producers": [
    {
      "addr": "<RELAY IP ADDRESS>",
      "port": <PORT>,
      "valency": 1
    }
  ]
}

Configure the relay node:

Make your relay node talk to your block-producing node and other relays in the network by editing the topology.json file:

nano topology.json

{
  "Producers": [
    {
      "addr": "<BLOCK-PRODUCING IP ADDRESS>",
      "port": <PORT>,
      "valency": 1
    },
    {
      "addr": "<IP ADDRESS>",
      "port": <PORT>,
      "valency": 1
    },
    {
      "addr": "<IP ADDRESS>",
      "port": <PORT>,
      "valency": 1
    }
  ]
}

Note: If you want to connect to IPv4 and IPv6 relays, you must either not specify host addresses when starting cardano-node or make sure to specify both an IPv4 and IPv6 host address.

Please see Understanding configuration files to learn about P2P topology.