Creating a local cluster with the mkfiles script

Now that you know how the internals of a local cluster work, you can benefit from some automation. We have a script that can help you start a cluster that forks into Babbage era at epoch 0. It is located here:

Make sure to use cardano-node 8.0.0

cardano-node --version
cardano-node 8.0.0 - linux-x86_64 - ghc-8.10
git rev 69a117b7be3db0f4ce6d9fc5cd4c16a2a409dcb8

To create a local-cluster using, please clone cardano-node repo and checkout tagged version 8.0.0

git colne
git checkout tags/8.0.0 script is currently set to start the cluster on Conway era, but Conway development is still in progress and most of the functionalities of cardano-node will not work just yet.

We need to edit the file scripts/babbage/ file to ensure that our cluster starts in Babbage era. All we have to do is comment (#) this line on the script:

# echo "TestConwayHardForkAtEpoch: 0" >> "${ROOT}/configuration.yaml" 

Save your changes,

It is recommended to have 3 additional terminals ready, one for each node. When you are ready, run the script.

generated genesis with: 3 genesis keys, 3 non-delegating UTxO keys, 3 stake pools, 3 delegating UTxO keys, 3 delegation map entries,

Then, run a node on each terminal. For example:

Terminal 1


Terminal 2


Terminal 3


Note that you have 30 seconds to start the 3 nodes. To give yourself more tim, you can change this line on the script:

START_TIME="$(${DATE} -d "now + 30 seconds" +%s)"

After starting your nodes, make sure to set the CARDANO_NODE_SOCKET_PATH on your working terminal:


and voilà! We have a cluster running on Babbage era with very little effort:

cardano-cli query tip --testnet-magic 42
    "block": 3519,
    "epoch": 70,
    "era": "Babbage",
    "hash": "dd38083ef4392502218e71c6364bcfefdef1f9e6563f27fa1db2196e1c65b786",
    "slot": 35361,
    "slotInEpoch": 361,
    "slotsToEpochEnd": 139,
    "syncProgress": "100.00"

Last updated