Skip to main content

Dor Quick Start

This guide is specifically for setting up your Dor Node, and is opinionated with sensible defaults.

â—½ Choose VPS Provider

Refer to the Constellation Network Setup Guides for choosing a VPS provider.

â—½ Setup Firewall

directionportdescription
inbound9010public api layer1
inbound9011p2p api layer1
outboundallTune to your needs

Refer to these guides on Digital Ocean, AWS, and Hetzner.

note

Setting up your firewall policy prior to building your VPS will save time.

â—½ Provision Your VPS

Minimum specification for your VPS

Refer to the specification document for validation.

Suggested OS: Ubuntu 22.04

Ubuntu 24.04 is currently not supported.

â—½ SSH into Your VPS

ssh -i /path/to/ssh/private/key nodeadmin@vps_ip_address

Refer to SSH Explanation, Mac SSH Guide, and Windows SSH Guide for detailed understanding.

â—½ Update OS

sudo apt -y update && sudo apt -y upgrade

â—½ Reboot

sudo reboot now

SSH into your VPS again using the default user set by your VPS provider (e.g., root or ubuntu).

â—½ Install nodectl

Node Control Utility Program v2.15.1

sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.15.1/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

â—½ Start Tessellation Installation

sudo nodectl install --quick-install

â—½ Select Cluster to Configure/Join

  • Choose 4 (dor [metagraph])

â—½ Decline P12 Migration Request

  • We will choose n to decline the migration.

â—½ Node Administration Account Password

Input and confirm the nodeadmin's new strong password that will be used to administer your Node.

Password Entry

You will not see the password output or the * character while entering your password. This is a Linux level security feature.

â—½ P12 Keystore Passphrase

Input and confirm a complex passphrase that will be used to unlock your Node's ability to access the network and to administer your Node's wallet.

  • Must have at least 1 uppercase letter
  • Must have at least 1 lowercase letter
  • Must have at least 1 number
  • Must have at least 1 special character
  • Must NOT have any spaces
  • Must NOT have a section sign §
  • Must NOT have a dollar sign $

â—½ Wait for Installation to Complete

No action required, you can wait for the installation to complete.

Please follow the instructions below, as indicated

1) Submit your NodeID to Constellation Discord Admins.
2) Collateralize your Node's wallet.
3) Stay logged in to this VPS terminal session. 4) Open new terminal. 5) Confrim ability to log in as: nodeadmin 6) Log out of this original terminal session.
7) Wait for next cluster restart
8) Confirm your node's status
  - sudo nodectl check_seedlist -p dag-l0
  - sudo nodectl restart -p all

🚑  Leave this screen up and remote terminal window open!

â—½ Test Access

  1. Leave your root or ubuntu user connected to your Node's terminal.
  2. Open a new local terminal and attempt a second SSH remote connection to your Node using your nodeadmin user and passphrase as created in the SSH into Your VPS.

After confirming you have access via nodeadmin you can move to the next step.

â—½ Submit your Node Details

  1. Connect to the Constellation Network Official Discord Support Server.
  2. Reach out to an Administrator.
  3. Supply and request to have your nodeid appended to the Dor metagraph access seed list.

You will see your Node ID, displayed on the instructional screen at the end of the installation.

Example 128 length hexadecimal number.
136f0f756659be91e8af013aa9e2a63a94227680aa41365e055a37db206f69d313e479e7f37e8c9c13fa40278ddc98eab2b0130fc0cf17fdf13ca012082ba813

â—½ Back Up Your Node P12

Refer to these guides

â—½ Secure Storage of Passwords

Ensure that you have recorded all the passphrase(s) and other pertinent information via your notes, to a secured air gapped location.

You may reference our Node Operator Notes for an idea on what to record.

â—½ Close Terminals

After completing the access test successfully, you can close out all terminal sessions, leaving only your nodeadmin connected terminal session open.

IMPORTANT

Your Node will no longer be accessible via the root or default ubuntu account you originally setup your Node to access.

â—½ Collateralize your Node

Refer to the collateralize your node start guide.

â—½ Congratulations

Your Node installation is complete.

â—½ Next Steps

IMPORTANT

You will need to wait for your node's nodeid, that was submitted here, to be added the seed list (access/authorization list) before you can join the cluster.

Follow the first time Connection quick start guide to bring your node on the network.

Contents