Constellation Network
IntroductionFundamentalsFor DevelopersNode Validators
  • Index
  • Validator Node Guides
    • πŸ’°Delegated Staking
      • What is delegated staking?​
      • For Node Operators
      • Understanding Delegated Staking
      • Prerequisites
      • Create Delegated Staking Configuration
      • First Time Configuration
      • Modify Existing Configuration
      • Add/Update Delegating Staking Parameters
      • Update Delegated Staking
      • Duplicate Update
      • Status Command
    • 🚧Build Your Node
      • Create Discord Account
      • πŸ—’οΈNode Operator Notes
      • βš™οΈNode Specifications
      • 🚧Generic Build a VPS Guide
      • ☁️Cloud Provider Specific
        • 🚧Build AWS EC2 Instance
        • 🚧Build DigitalOcean Droplet
        • 🚧Build Hetzner Server
      • πŸš‰First Time Connection Guide
      • πŸ’½The nodectl utility
      • Download nodectl
      • πŸ—οΈTurn your VPS into a Node
        • 🚩Node Prerequisites
        • πŸ‡Quick Install Guide
        • 🎨Normal Install Guide
        • πŸ› οΈManual Installation
      • πŸ†Authorize to Join Hypergraph or metagaph
    • πŸ’°Collateralize Your Node
    • 1️⃣First Time Cluster Connection
    • πŸ’«Enable Auto Restart
    • πŸ“‚Operational Guides
      • ♻️Restart Validator Node Guide
      • 🐎Upgrade Tessellation Quick Start
      • 🏭Upgrade Tessellation Guide
      • πŸ—οΈReinstallation Guide
      • ♻️Backup/Restore a P12 KeyStore
      • πŸš‹Migrate V1 to V2 - P12 Keystore
      • πŸ›«Upgrade nodectl Version
      • 🚨Alerting & Reporting Setup Guide
    • πŸ› οΈTroubleshooting Guides
      • πŸ—οΈTroubleshoot SSH Connection
      • πŸ’½Troubleshoot nodectl upgrade
      • ⛰️Troubleshoot EdgePointDown Message
      • 🚨Troubleshoot Node Alerting
  • πŸ‘‘MainNet
    • MainNet & IntegrationNet Quick Start Guide
    • 🚧Upgrade Tessellation to v3
    • 🦌Migrate an IntegrationNet Node to MainNet
  • πŸ₯…IntegrationNet
    • πŸ§ͺIntegrationNet Quick Start Guide
  • Metagraphs
    • πŸšͺDor metagraph
      • πŸšͺDor Validator Onboard Guide
      • πŸšͺUnderstanding Rewards
      • πŸšͺTechnical Procedures
        • πŸšͺBuild Dor Validator Node
  • πŸ“šReferences
    • πŸ“šnodectl Command Reference
    • Firewall Settings Table
    • πŸ”SSH Remote Access
      • πŸ”‘Create SSH Keys
      • πŸ“Upload SSH Public Key
      • πŸ”Securing SSH Access
      • ♻️How to SSH into VPS
    • 🍴Node Fork Types
    • πŸ—οΈP12 Keystore
    • 🏐Tarball
    • πŸ’»Virtual Private Server
  • GitHub nodectl utility
  • Lattice Dashboard
Powered by GitBook

Main

  • Website
  • Get DAG
  • Explore Projects
  • Partners

Socials

  • Telegram
  • Discord
  • X (Twitter)

Tools

  • Wallet
  • DAG Explorer
  • Coingecko

Β© 2025 CONSTELLATION NETWORK

On this page
  • Introduction
  • πŸŽ‰ Congratulations!

Was this helpful?

Export as PDF
  1. Validator Node Guides
  2. Operational Guides

Upgrade nodectl Version

Upgrade your node control utility.

PreviousMigrate V1 to V2 - P12 KeystoreNextAlerting & Reporting Setup Guide

Last updated 19 days ago

Was this helpful?

Introduction

This guide provides a streamlined process to upgrade your nodectl utility to the latest supported version, while following the recommended upgrade path.


1

Access your Node

2

Begin the Upgrade Process

sudo nodectl upgrade_nodectl
3

Choose the Correct Upgrade Path

You will be prompted to select between two available versions:

  • The latest version

  • The last known upgrade path version

⚠️ Important: Select the version that follows the recommended upgrade path. Skipping versions may result in misconfiguration or compatibility issues.

  • Press the corresponding number key (no need to press Enter).

  • Press y to confirm your selection.

4

Verify the Upgrade Signature

After download, ensure the following message appears:

SUCCESS - AUTHENTIC NODECTL

🚫 If you see:

INVALID SIGNATURE - WARNING

Stop immediately. Do not run additional commands. Report the issue via the Constellation Network Official Discord to verify the integrity of your upgrade and prevent potential malicious activity.

5

Tessellation Upgrade (If Prompted)

You may now be asked whether to upgrade Tessellation as part of the upgrade flow.

  • πŸ›‘ If not required: Skip to next step

  • βœ… If required: Press y and follow the prompts

You may optionally refer to the full for details before continuing

6

Restart Auto Restart Feature (Optional)

If you’re using the auto_restart feature, it’s recommended to manually restart it to ensure any upgrade-related updates are applied:

sudo nodectl auto_restart restart

πŸŽ‰ Congratulations!

Your node is now running the latest version of nodectl, fully updated and ready for continued participation in the Constellation Network.


You can confirm your version using:

nodectl version
πŸ“‚
πŸ›«
♻️How to SSH into VPS
Tessellation upgrade guide