How to Set up a Local Parachain Testnet

Set up a local parachain testnet to test and debug various XCM scenarios.

parachain-launch

parachain-launch is a script that generates a docker compose file allowing you to launch a testnet of multiple blockchain nodes.

The following options are supported by the generate script.

Option	Description	Required	Default
–config	Path to config file.	No	./config.yml
–output	Path to output dir.	No	./output
–yes	Overwrite generated files?	No	false

yarn global add @open-web3/parachain-launch

parahain-launch generate --config=/path/to/config.yml [--yes] [--output=/path/to/output]

This will generate the docker files a folder called output in your current working directory or in the directory provided to the --output option.

yarn add @open-web3/parachain-launch

node_modules/.bin/parahain-launch generate --config=/path/to/config.yml [--yes] [--output=/path/to/output]

This will generate the docker files a folder called output in your current working directory or in the directory provided to the --output option.

To start the nodes, navigate to the output folder that you generated the scripts in and build the docker container:

cd ./output # OR custom output directory

docker-compose up -d --build

NOTE: If you regenerate the output directory then you will need to rebuild the docker images.

List all of the containers:

docker ps -a

Track container logs:

docker logs -f [container_id/container_name]

Stop all of the containers:

docker-compose stop

Remove all of the containers:

docker-compose rm

If you want to clear the data and restart the you will need to clear the volumes.

Remove volume:

docker volume ls
docker volume rm [volume_name]

Prune all volumes:

docker volume prune