Docs
Submit an issue
Appchains on Polkadot
Appchains on Polkadot
  • WELCOME
    • Polkadot Appchains
    • Installing Pop CLI
    • How to contribute
  • GUIDES
    • Set up your development environment
    • Create a new parachain
      • Create an Assets parachain
      • Create a Contracts parachain
      • Create an EVM parachain
    • Benchmarking
    • Build your parachain
      • Build your runtime deterministically
    • Call a chain
    • Launch a Chain
      • Launch a Chain in Development
      • Launch a Chain to Paseo
        • Launch Paseo
        • Set up keys
        • Acquire Coretime
      • Deploy a chain with Polkadot Deployment Portal
      • Running a post-startup command
    • Securely Sign Transactions from CLI
    • Test runtime upgrades
  • POP CLI
    • welcome
    • install
    • new
    • bench
    • build
    • build spec
    • call
    • up
    • clean
    • test
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. GUIDES
  2. Launch a Chain

Launch a Chain in Development

PreviousLaunch a ChainNextLaunch a Chain to Paseo

Last updated 1 month ago

Was this helpful?

To run your parachain, you will need to spin up a local network with your parachain configuration.

The pop up command can help with this.

pop up network --help

For Pop CLI versions <0.7.0 the pop up network command is pop up parachain

Say we want to spin up a local network for your parachain. First we need to define a network configuration file. You can do this in the root of your project.

cd my-appchain
touch network.toml

Add the following configuration, adapting as necessary.

You can use paseo-local for your Relay chain. Paseo is the community-led Polkadot Test Relay chain.

[relaychain]
chain = "paseo-local"

[[relaychain.nodes]]
name = "alice"
validator = true

[[relaychain.nodes]]
name = "bob"
validator = true

[[parachains]]
id = 2000
default_command = "./target/release/parachain-template-node"

[[parachains.collators]]
name = "collator-01"

This network configuration will launch a relay chain using a paseo-local instance of Polkadot with two validator nodes to run the network: alice and bob. It will also run parachain-template-node with one collator node named collator-01.

Cool. Let's spin this up, ensuring that your parachain binary has been built using pop build parachain.

pop up network -f ./network.toml

If this is the first time you are running the pop up command, it will prompt you to source the required Polkadot binaries. This will take some time, grab some coffee.

Once all the binaries are sourced, you should have output similar to this.

┌   Pop CLI : Deploy a parachain
│
◇  🚀 Network launched successfully - ctrl-c to terminate
│  ⛓️ paseo-local
│       alice:
│         portal: https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:62551#/explorer
│         logs: tail -f /var/folders/vl/txnq6gdj22s9rn296z0md27w0000gn/T/zombie-c0eb16fc-5d11-4792-aced-493ef972d056/alice/alice.log
│       bob:
│         portal: https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:62555#/explorer
│         logs: tail -f /var/folders/vl/txnq6gdj22s9rn296z0md27w0000gn/T/zombie-c0eb16fc-5d11-4792-aced-493ef972d056/bob/bob.log
│  ⛓️ local_testnet: 2000
│       collator-01:
│         portal: https://polkadot.js.org/apps/?rpc=ws://127.0.0.1:62559#/explorer
│         logs: tail -f /var/folders/vl/txnq6gdj22s9rn296z0md27w0000gn/T/zombie-c0eb16fc-5d11-4792-aced-493ef972d056/collator-01/collator-01.log
│

Congrats! You have now spun up a network with your parachain running!

Learning Resources

Technical Support

Under-the-hood, Pop CLI uses zombienet to spin up the network. For more advanced network configurations and options consult the

🧑‍🏫 To learn about Polkadot in general, website is a good starting point.

⭕ Learn more about parachains .

🧑‍🔧 For technical introduction, are the Polkadot SDK documentation resources.

Create a question and tag it with ""

Share the StackExchange question in our

zombienet
zombienet repo
Polkadot.network
here
here
Polkadot Stack Exchange
pop
Pop Support Telegram channel