Dor Quick Start
This guide is specifically for setting up your Dor node, and is opinionated with sensible defaults.
â—½ Qualifications
In order to qualify to become a Dor Validator node Operator you will need to handle a few administive tasks.
Please refer to the following document to learn how to become a Dor validator node Operator.
â—½ Choose VPS Provider
Refer to the Constellation Network Setup Guides for choosing a VPS provider.
You may follow along in the setup guides for step-by-step; otherwise, return here after you decided on a VPS service provider to continue with the quick start guide.
â—½ 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.
You may return to this quick start guide once you have your VPS built.
â—½ Verify Firewall Setup
If you are returning from the VPS build documentation, you should already have a firewall configuration in place. Please verify the following configuration for your firewall is properly setup.
direction | port | description |
---|---|---|
inbound | 9010 | public api layer1 |
inbound | 9011 | p2p api layer1 |
outbound | all | Tune to your needs |
caution
A Dor validator node is a single layer1 configuration.
You should not have ports 9000-9001 open.
Refer to these guides on Digital Ocean, AWS, and Hetzner.
note
Setting up your firewall policy prior to building your VPS will save time.
â—½ 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.2
sudo wget -N https://github.com/stardustcollective/nodectl/releases/download/v2.15.2/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.
1) Submit your node ID 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
- Leave your
root
orubuntu
user connected to your node's terminal. - 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
- Connect to the Constellation Network Official Discord Support Server.
- Reach out to an Administrator.
- Supply and request to have your
node ID
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.
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 node ID, 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.