Skip to main content

VPS Build Quick Start

This guide is specifically for setting up your VPS to build a Constellation Network node. It is a general guide only.

◽ Before We Begin (optional)

This guide does not include cloud provider-specific steps or images.

notes: ▼

If you do not want to use the step-by-step guides, continue with this guide by skipping to the create SSH key section below.

Use the VPS setup step-by-step.

Constellation Network currently offers setup guides for:

  • AWS
  • Digital Ocean
Hetzner users can follow the DigitalOcean guides and adapt them to Hetzner's setup wizards, as the procedures are very similar.

◽ Create SSH Keys

Please access the Create SSH Key quick start guide to build your SSH key pair.

This is necessary to have in place before continuing.

Return to this guide when completed.

◽ Select Project

Choose or create a new project that will be used to organize your VPS instances.

Missing Projects

Not all cloud providers require this step, skip if not found.

◽ Create a Firewall

Create your firewall or security group policy first.

Firewall Mappings Chart

directionportdescription
inbound9000public api layer0
inbound9001p2p api layer0
inbound9010public api layer1
inbound9011p2p api layer1
outboundallTune to your needs
note

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

  • AWS should create a security group.
  • GCP should create a firewall.
  • Digitial Ocean should create a firewall.
  • Hetnzer should create a firewall (you can follow the DO step-by-step).

◽ Build Wizward

Click on a new server build.

◽ Choose a Region

Choose a region that is closest to your local location.

◽ Pick an image

Choose Ubuntu 22.04

In most cases their will be a dropdown to select the version of Ubuntu or mulitple names for the Ubuntu image that will contain the version `22.04` in the image name.

🛑 STOP

Do not choose Ubuntu 24.04 or a non-Debian distribution.

◽ Tenancy

Choose shared CPU or shared tenancy.

◽ Provision Your VPS

Minimum specification for your VPS

MainNet, IntegrationNet, TestNet Hybrid Node

Refer to the specification document for validation.

Dor and single layer metagraphs

Refer to the specification document for validation.

◽ Prepare your public SSH key

Open your public key SSH key to view its contents.

In the example steps below:

Please choose Windows or Macintosh platform.

◽ Upload your public SSH key

In the previous step, an editor containing the contents of your public SSH key should have opened.

The key contents should likely start with either:

  • ssh-rsa
  • ssh-ed25519

It should end with your SSH key comment. If you're following our guides directly, it will end with ConstellationNetwork; otherwise, it will end with the comment you chose or your computer's username.

Digitial Ocean and Hetzner
  1. Click on the upload our new SSH key button option.
  2. Copy the contents of your public key into the modal and add the key.
AWS
  1. Use the Actions menu from the Region you are building your VPS (EC2) instance within and select Import key pair.
  2. Copy the contents of your public key into the modal and add the key.

You may close the editors upon completetion of this step.

◽ Assign EIP (AWS only)

If you are not using AWS, you can skip this step.

You will need to assign an EIP (Elastic IP) to allow your future Node to persist on the Internet.

  1. Choose Elastic IP from the side menu.
  2. Choose your Region.
  3. Allocate an EIP.
  4. Associate your EIP your instance after the instance is created through the action menu.

◽ Optional Services

You may skip all the additional services offered. You can treat your node as an ephemeral device and simply rebuild it in the event of any issues.

◽ Create your VPS

Click on the create (or related) button.

◽ VPS Build Process

Your VPS should now begin its creation, and you should be able to access it shortly via SSH.

Wait for your provider's quick wizards to complete the build, and then record the external IP address of your newly created VPS for future access.

◽ Update Notes

Create a notes document or update your notes documentation with your new information:

  • IP address of your new VPS.
  • SSH key pair assigned to your VPS.

◽ Complete

You may now return to the Quick Start Guides to select the cluster in which you would like to continue building your node for participation.

Contents