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.
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..
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 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 .
Enter and confirm the .
9
P12 Keystore Passphrase
You will be prompted to enter a 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 .
Enter and confirm the .
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.
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 .
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 to bring your node online.
