Skip to main content

Setup collator Node


How do you setup an Collator Node?#

This guide covers how to set up a DataHighway Collator Node.

Provisioning a server#

Provision an appropriately sized server from a reputable VPS provider, e.g.: Vultr, DigitalOcean, Linode, OVH, Contabo, Scaleway, Amazon AWS, etc.

We recommend a node with at least 4GB of RAM, and Ubuntu 18.04 x64. Other operating systems will require adjustments to these instructions.

SSH into the server.

Installing DataHighway and setting it up as a system service#

First, clone the DataHighway-DHX/node repo, install any dependencies, and run the required build scripts.

apt updateapt install -y gcc libc6-devapt install -y cmake pkg-config libssl-dev git clang libclang-dev

Prefetch SSH publickeys

ssh-keyscan -H >> ~/.ssh/known_hosts

Install rustup

curl -sSf | sh -s -- -ysource $HOME/.cargo/envexport PATH=$HOME/.cargo/bin:$PATH

Get packages

git clone node

Build packages

curl -sSf | bash -s -- --fast && \./scripts/

Build runtime code

cargo build --release

Set up the node as a system service.#

To do this, navigate into the root directory of the DataHighway-DHX/node repo and execute the following to create the service configuration file. Replace the values for keys starting with $ to suit your own collator node

{  echo '[Unit]'  echo 'Description=DataHighway'  echo '[Service]'  echo 'Type=simple'  echo 'WorkingDirectory=$fullprojectpath'  echo 'ExecStart=$fullprojectpath/target/release/parachain-collator --collator --name $nameofyournode -parachain-id 2 --port 40334 --ws-port 9845 --bootnodes $dhxbootnode -- --chain rococo --port 30333 --ws-port 9978 --bootnodes $dhxbootnode'  echo '[Install]'  echo ''} > /etc/systemd/system/datahighway.service

$dhxbootnode= requst this from DHX team thru discord

$fullprojectpath=needs to be the full path to your node project which you cloned. eg:


$nameofyournode=name your node with the --name option which will be shown on telemetry (not supported yet), eg:

--name Mycollator

Double check that the config has been written to /etc/systemd/system/datahighway.service correctly.

cat /etc/systemd/system/datahighway.service

Then enable the service so it runs on startup, and then try to start it now:

systemctl enable datahighwaysystemctl start datahighway

Check the status of the service:

systemctl status datahighway

You should see the node connecting to the network and syncing the latest blocks. If you like to follow the log output, you can use:

journalctl -u datahighway.service -f