# 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.**

{% content-ref url="/pages/2N552rmMiR8EK616NuRV" %}
[Node Prerequisites](/run-a-node/validator-node-guides/build-your-node/turn-your-vps-into-a-node/node-prerequisites.md)
{% endcontent-ref %}

***

## Begin Quick Install

{% stepper %}
{% step %}

### 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)

{% hint style="danger" %}
**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. &#x20;

It is strongly advised to clear your history after the installation completes with the `history -c` command ( `-c`= clear )
{% endhint %}
{% endstep %}

{% step %}

### 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 <kbd>H</kbd> to build a Hypergraph validator node or <kbd>D</kbd> 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
```

{% endstep %}

{% step %}

### Continue

If you node meets all the proper [specifications ](/run-a-node/validator-node-guides/build-your-node/node-specifications.md)you may press any key to continue.
{% endstep %}

{% step %}

### Build Begins

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

{% step %}

### 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 <kbd>1</kbd> through  <kbd>4</kbd> 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
```

{% endstep %}

{% step %}

### Migrating an Existing P12

You may enter <kbd>n</kbd> or just press <kbd>Enter</kbd> to accept the default `[n]` option.

{% hint style="success" %}

## 🔵 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.
{% endhint %}
{% endstep %}

{% step %}

### 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`&#x20;
* Defaults p12 keystore name `nodeadmin-node.p12`&#x20;
* Default alias `nodeadmin-alias`&#x20;
  {% endstep %}

{% step %}

### Create Your nodeadmin Password

You will be prompted to create a [password ](/run-a-node/validator-node-guides/build-your-node/node-operator-notes.md#understanding-passphrase-and-passwords)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.

{% hint style="info" %}
Reminder to use proper password [requirements](#password-and-passphrase-requirements).
{% endhint %}

**Enter** and **confirm** the [password](/run-a-node/validator-node-guides/build-your-node/node-operator-notes.md#understanding-passphrase-and-passwords).
{% endstep %}

{% step %}

### P12 Keystore Passphrase

You will be prompted to enter a [passphrase ](/run-a-node/validator-node-guides/build-your-node/node-operator-notes.md#understanding-passphrase-and-passwords)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.

{% hint style="info" %}
Reminder to use proper passphrase [requirements](#password-and-passphrase-requirements).
{% endhint %}

**Enter** and **confirm** the [passphrase](/run-a-node/validator-node-guides/build-your-node/node-operator-notes.md#understanding-passphrase-and-passwords).
{% endstep %}

{% step %}

### 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](/run-a-node/validator-node-guides/build-your-node/node-operator-notes.md)

{% endstep %}

{% step %}

### 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.
{% endstep %}

{% step %}

### Completed Install Screen

The `nodectl` utility will finish by displaying a final instructional page.&#x20;

Review it carefully, record any important information in your [notes](/run-a-node/validator-node-guides/build-your-node/node-operator-notes.md#notes-for-macintosh).&#x20;

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>
```

{% endstep %}

{% step %}

### 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**](/run-a-node/validator-node-guides/build-your-node/first-time-connection-guide.md) to bring your node online.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.constellationnetwork.io/run-a-node/validator-node-guides/build-your-node/turn-your-vps-into-a-node/quick-install-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
