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
  • Directly From The nodectl Utility
  • Manual Download

Was this helpful?

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

Troubleshoot nodectl upgrade

Resolve Issues When Upgrading Older Versions of nodectl

PreviousTroubleshoot SSH ConnectionNextTroubleshoot EdgePointDown Message

Last updated 18 days ago

Was this helpful?

Introduction

As nodectl evolves, the upgrade process also changes.

This guide helps bring your outdated nodectl installation up to the current recommended version using a versioned, step-by-step upgrade path.


Directly From The nodectl Utility

1

Check Your Current Version

sudo nodectl version
2

Determine Upgrade Path

sudo nodect upgrade_path
3

Follow upgrade path

Choose the next available version required by the output in the previous step.

sudo nodectl upgrade_nodectl -v <version_you_found_here>
4

Upgrade your Node

To verify that everything remains in perfect working order, issue a standard node upgrade.

You may omit the --ni if you would like an interactive experience.

sudo nodectl upgrade --ni

Manual Download


1

Releases page

Open your browser and visit the nodectl Releases Page.

2

Determine Version

Locate the version you want to install.

3

Obtain Download Link

Copy the direct download link for the release file that matches the Linux distribution you are running on your VPS.

4

Issue an upgrade

You may omit the --ni if you would like an interactive experience.

sudo nodectl upgrade --ni
๐Ÿ› ๏ธ
๐Ÿ’ฝ
Releases ยท StardustCollective/nodectlGitHub
Logo