How to run test node for noobs. -UPDATE 28.01.2020- with Video

Catapult Testnet Run for Noobs:

This process worked for me, i hope it can help! For this tutorial you will need a Ubuntu 18.04 Installer.
Please before you start watch the very boring video, it displays the complete process. I think it will help. Keep in mind that i am new to this and to Linux.

Hardware requirements

Catapult nodes have been tested on computers with the following minimum requirements .

  • CPU : 2 cores or more
    (4th gen intel CPUs wont work. Fix is probably on the way. I don’t know about 5th and 6th gen or any AMD CPUs. All i can tell is that every Intel from 7th gen up will work)

  • Memory : 4GB or more

  • HD : 20GB or more

  • OS : Linux or Mac / Ubuntu 18.04 Bionic was used for this Tutorial.

Install Ubuntu alongside your main OS. After every reboot you now can chose between the operating systems.
Get all updates and restart. Open web browser and open links provided underneath. Or copy paste the commands in the tutorial.

Note: The section in the video where you edit files in the bootstrap folder, is not required anymore

Docker Installation:

Docker Compose Installation:

Catapult Testnet Bootstrap:

Now start your terminal with Ctrl+Alt+T and run the commands :

First, update your existing list of packages:

sudo apt update

Next, install a few prerequisite packages which let apt use packages over HTTPS:

sudo apt install apt-transport-https ca-certificates curl software-properties-common

Then add the GPG key for the official Docker repository to your system:

curl -fsSL | sudo apt-key add -

Add the Docker repository to APT sources:

sudo add-apt-repository "deb [arch=amd64] bionic stable"

Next, update the package database with the Docker packages from the newly added repo:

sudo apt update

Make sure you are about to install from the Docker repo instead of the default Ubuntu repo:

apt-cache policy docker-ce

You’ll see output like this, although the version number for Docker may be different:

Output of apt-cache policy docker-ce

  Installed: (none)
  Candidate: 18.03.1~ce~3-0~ubuntu
  Version table:
     18.03.1~ce~3-0~ubuntu 500
        500 bionic/stable amd64 Packages

Notice that docker-ce is not installed, but the candidate for installation is from the Docker repository for Ubuntu 18.04 ( bionic ).

Finally, install Docker:

sudo apt install docker-ce

Docker should now be installed, the daemon started, and the process enabled to start on boot. Check that it’s running:

sudo systemctl status docker

Now open a second tab in terminal and install docker-compose by running:

We’ll check the current release and if necessary, update it in the command below:

sudo curl -L`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

Next we’ll set the permissions:

sudo chmod +x /usr/local/bin/docker-compose

Then we’ll verify that the installation was successful by checking the version:

docker-compose --version

This will print out the version we installed:

Outputdocker-compose version 1.21.2, build a133471

Now run:

  1. Download the the latest release of the package, or clone the repository directly using Git.

New Updated Line 28.01.20

git clone
  1. Choose the assembly distribution you want to install.

In short, if you want to be able to interact with your node, you need to run the API assembly. On the other hand, if you want a node dedicated exclusively confirm transactions, deploy the peer assembly.

cd symbol-testnet-bootstrap/api-harvest-assembly


cd symbol-testnet-bootstrap/peer-assembly
  1. Run the node with docker-compose .
sudo docker-compose up --build --detach

You should see docker downloading the container images for the first time, then it should run the setup and finally startup the service.

If you have installed the api-harvest-assembly distribution, you can verify as well that the node is running by opening a new browser tab with the following URL: localhost:3000/chain/height

Your Node should be running and syncing.


Nice work!


Is it more beneficial to interact with the node? Because I would just run a node dedicated to confirming the transactions.

Also thank you very much for this tutorial, much appreciated.

1 Like

you can do both

1 Like

Thank you for doing this, I’ll try to set up a test node through your guide. Superb work!

1 Like

Thanks, good work. Will use this for set up. Was wondering whether this Symbol node can be installed on the same machine as my current NEM node, and co-exist without issues.


May I ask what is the complete specs of your computer that you used for this setup?

1 Like

sure , i use a dell latitude 5285, i5 7th gen, 8 gb of ram 120gb diskspace and the ubuntu 18.04 build


Thank you very much for these infos. :slight_smile:

1 Like

Thanks for this, was able to get my testnode up and running :+1:
Doesnt seem to have a complete list of nodes, as you cant scroll


Cant tell what it is, i have the same issue. It might be my Bit defender or some other Security program blocking :man_shrugging: good to know I m not the only one.

1 Like

Thank you for guide! Got my testnode now :slight_smile:
As I can see on explorer - only 26 testnodes running. It seems doesn’t enough for good testing.



yeah there is a issue with the explorer, there are more nodes up.

1 Like

git source changed to symbol-testnet-bootstrap. be sure to update!

1 Like

This topic was automatically closed 60 days after the last reply. New replies are no longer allowed.