🐇Quick Install Guide

Turn your VPS into a node using quick install guide

This guide walks you through the fully automated “quick-install” of a Constellation validator node using nodectl’s --quick-install mode. All defaults are recommended settings, and you’ll see a live progress bar throughout.

🚩Node Prerequisites

---

Begin Quick Install

1

Start the installation using quick install

sudo nodectl install --quick-install

For advanced users, if you prefer one-command install, supply any of these flags:

• --p12-passphrase <pass>

• --p12-alias <alias>

• --user <username>

• --user-password <password>

• --p12-destination-path <path>

• --p12-migration-path <path>

• --confirm (auto-accept warnings)

Warning: If you use any of the options/flags to supply a password or passphrase at the command line, these sensitive flags end up in your shell's history.

It is strongly advised to clear your history after the installation completes with the history -c command ( -c= clear )

2

Verify Specifications

When you first launch the nodectl utility, it will guide you through selecting the type of validator node you wish to install.

Choose H to build a Hypergraph validator node or D to build a Dor Data Layer 1 validator node..

  ========================================
  =   CONSTELLATION NETWORK HYPERGRAPH   =
  =          VERIFY NODECTL SPECS        =
  =         PRE-INSTALLATION TOOL        =
  ========================================
  Code Name: Princess Warrior

  Please choose node type to test:
  H)ybrid Dual Layer
  D)or Validator
  Q)uit

  KEY PRESS an option

3

Continue

If you node meets all the proper specifications you may press any key to continue.

4

Build Begins

You can now sit back and monitor the progress as nodectl begins building your node using all the recommended options.

5

Assign Your Cluster

After a few moments, you will be prompted to select the cluster you wish to join.

Based on your selection, nodectl will download a predefined configuration tailored to the chosen Hypergraph or metagraph cluster.

Choose 1 through 4 depending your requirements.

  HYPERGRAPH or METAGRAPH
  predefined choices
  -------------------------------------------
  1) mainnet [HyperGraph]
  2) integrationnet [HyperGraph]
  3) testnet [HyperGraph]
  4) dor-metagraph-mainnet [metagraph]

  Q)uit

  KEY PRESS an option

6

Migrating an Existing P12

You may enter n or just press Enter to accept the default [n] option.

🔵 Coming from the Migration Guide?

If you are performing a New Node Installation with .p12 Migration, you may press y at this prompt to allow nodectl to automatically scan your VPS for any available .p12 keystore files. Once detected, you will be presented with a list to select from, choose the appropriate file to continue the installation.

7

Node Administrator Password

No action is needed here.

You will see validation of your choice to join a specific cluster including:

• Hypergraph or metagraph cluster name

• Default username nodeadmin

• Defaults p12 keystore name nodeadmin-node.p12

• Default alias nodeadmin-alias

8

Create Your nodeadmin Password

You will be prompted to create a password for the nodeadmin user, which will serve as the default user on this VPS/node. This password will be required to execute administrative commands using nodectl going forward.

Reminder to use proper password requirements.

Enter and confirm the password.

9

P12 Keystore Passphrase

You will be prompted to enter a passphrase for your node’s .p12 keystore (wallet). This passphrase is required to perform signing requests and access your node’s hot wallet on the blockchain.

Reminder to use proper passphrase requirements.

Enter and confirm the passphrase.

10

Record For Later

It is important to securely record your username, password, .p12 keystore filename, keystore passphrase, and node alias for future reference. These details are easy to forget and losing them could lead to serious consequences.

Node Operator Notes

11

Allow Installation to Complete

The installer now has all the necessary information to complete the node setup.

You can sit back and relax while your node is automatically built.

12

Completed Install Screen

The nodectl utility will finish by displaying a final instructional page.

Review it carefully, record any important information in your notes.

The following instructions will be explained in greater detail in the post-seeding documents available on our documentation hub.

 ------ * INSTALLATION COMPLETE * -------

  CONGRATULATIONS!
  Below you will find your nodeid which 
  was derived from your p12 file
  Please report this nodeid to administrative 
  staff to gain access to the network via the 
  access  list permissions.

  HyperGraph/metagraph ..................... hypergraph
  Environment .............................. mainnet
  P12 Location ............................. /home/nodeadmin/tessellation
  P12 Name ................................. nodeadmin-node.p12
  P12 Alias ................................ nodeadmin-alias

   ----- * CHECK SEED LIST REQUEST * ------

  NODE ID
  <your_node_id_here>
  NODE ID FOUND ON SEED LIST
  False
  DAG WALLET ADDRESS
  <your_dag_wallet_address_here>

13

Final instructions

Now that your VPS has been successfully configured as a Constellation Network node, there are a few final steps to complete before proceeding to the First-Time Connection Guide to bring your node online.