Skip to main content

Full Node Configuration

The IOTA full node configuration file is a YAML file (usually named fullnode.yaml) that you can use to configure your iota-node. To smooth the setup process, you can use a full node configuration file template and modify it to your needs.

Depending on the network you want to connect to, you need to adjust the peering configuration in the configuration file and download a correct genesis blob (for more details, see the genesis page). Download the latest version of the IOTA full node configuration for the network you want to connect to:

wget -O fullnode.yaml https://github.com/iotaledger/iota/raw/develop/crates/iota-config/data/fullnode-template-testnet.yaml

This default template uses default ports, archive and pruning settings, and also covers peering configuration for the selected network. If you're fine with the default settings, you can use the template as is and continue with the node setup either using Docker or build it from source.

For more specific guidance on how to configure your node to suit your needs, e.g., configure snapshot, refer to the following sections:

  • Genesis - more details on genesis.
  • Network - peering configuration for the node.
  • Pruning - how to prune your IOTA Full Node to leverage storage space.
  • Snapshots - how to configure formal and RocksDB snapshots for your IOTA Full Node.
  • Archives - how to configure archives for your IOTA Full Node.