OnFinality supports creating nodes in various protocols from any public docker image. In this tutorial, we'll add the network-spec for a custom network so that later you and your team can deploy your own nodes into it.

In this tutorial, you will learn how to create a brand new one-validator network from your own substrate-based image.

You might want to use it to run some tests, or join more nodes into it to simulate a more complicated scenario. And you are safe to delete the whole network after you're done, and pay only a small price for it since we charge on an hourly basis.


  1. A well constructed public substrate-based image on DockerHub or GitHub (see our Docker image guide here)

  2. A workspace with credit card bound


Create or Join a Network

  1. Firstly, Login (opens new window) to your OnFinality account and go to the Networks page. Here, click on Create Network Spec up in the top right of your screen.

Enter Network Details

On this page you'll enter some key information about the network that you are joining or registering

Currently we only support joining or creating custom substrate networks (and there are plenty of them!) but this will be expanded in the future.

  1. Display Name: Give the network a memorable name, and then select the Protocol this network follows.

  • Image Repository is the public docker name of the network's nodes

    Image Repository Version is the specific tagged version of that repository you want to take the code off

  1. Once you've entered all details on this page, click Next.

Add Network Argument Rules

We will then inspect the image version that you submitted and attempt to guess the arguments that you need to run the image for each different node type.

For each node type, please confirm all the arguments and configuration steps


  • Please provide the arguments required to start the parachain node

  • The Value represents the default value of that argument

  • Enabling Lock will mean the user can not override this default argument value

Environment Rules

  • If the node requires certain values to be set on the environment, you can enter them here

  • Enabling Lock will mean the user can not override this default environment value

Recommended Configuration

  • Please set the recommended node size and storage size for each node type. This will be the default when a user goes to create a new node from this network spec.

Congratulations, now go add your own node to this network

You'll now see the custom network you’ve created Networks page. Now you can go to the Nodes page and Deploy a Dedicated Node in your new custom network