Skip to main content

New Install - Download nodectl

Latest Release

Download the latest version of nodectl.

warning

Make sure you download the latest version of nodectl. Even though the documentation may reflect the current latest version, it is recommended to verify the version is the latest, to ensure your node will have the latest features and capabilities.

Documentation can become outdated; however, the basic methods and actions will remain the same; as well as, Constellation will update the documentation on a need-to basis.

Download Release

Open your web browser and enter in:

https://github.com/StardustCollective/nodectl/releases

Access nodectl releases

  1. Click on the version that has the latest tag.
  2. Find the Manual Installation section
  3. Find the appropriate link based on the architecture that matches your VPS.
  4. highlight and copy to your clipboard or click on the clipboard icon on the right side of the box with the link embedded.

  1. Paste the copied link into your VPS terminal window.

Windows users using PuTTy should make sure the PuTTy window is in focus (selected) and then right-click with the mouse to paste the link into your PuTTy terminal.

A right-click is the paste function in PuTTy.

Macintosh users using a normal terminal will make sure the terminal window is in focus (selected) and then use command+v to paste into the terminal.

The command pasted into your VPS 👇 will be a collation of commands in a single line of execution.

Execute the download

sudo nodectl auto_restart disable; sudo wget https://github.com/netmet1/constellation_testnet_nodectl/releases/download/v2.15.2/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v

Execution and output results

ubuntu@ip-172-31-90-241:~$ sudo nodectl auto_restart disable; sudo wget https://github.com/netmet1/constellation_testnet_nodectl/releases/download/v2.15.2/nodectl_x86_64 -P /usr/local/bin -O /usr/local/bin/nodectl; sudo chmod +x /usr/local/bin/nodectl; sudo nodectl -v
sudo: nodectl: command not found
--2023-05-01 20:16:11-- https://github.com/netmet1/constellation_testnet_nodectl/releases/download/v2.7.0/nodectl_x86_64
Resolving github.com (github.com)... 113.113.113.113
Connecting to github.com (github.com)|113.113.113.113|:443... connected.
HTTP request sent, awaiting response... 302 Found
Location: https://objects.githubusercontent.com/github-production-release-asset-2e65be/543118169/2cd1e3c0-b1d1-438b-853e-7c550358d624?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIWNJYAX4CSVEH53A%2F20230501%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230501T201611Z&X-Amz-Expires=300&X-Amz-Signature=0bd2f9432a9886f18219b71423de0665b2c7d586d47e34115dabf60e88aadaaf&X-Amz-SignedHeaders=host&actor_id=0&key_id=0&repo_id=543118169&response-content-disposition=attachment%3B%20filename%3Dnodectl_x86_64&response-content-type=application%2Foctet-stream [following]
--2023-05-01 20:16:12-- https://objects.githubusercontent.com/github-production-release-asset-2e65be/543118169/2cd1e3c0-b1d1-438b-853e-7c550358d624?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIWNJYAX4CSVEH53A%2F20230501%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20230501T201611Z&X-Amz-Expires=300&X-Amz-Signature=0bd2f9432a9886f18219b71423de0665b2c7d586d47e34115dabf60e88aadaaf&X-Amz-SignedHeaders=host&actor_id=0&key_id=0&repo_id=543118169&response-content-disposition=attachment%3B%20filename%3Dnodectl_x86_64&response-content-type=application%2Foctet-stream
Resolving objects.githubusercontent.com (objects.githubusercontent.com)... 185.199.110.133, 185.199.111.133, 185.199.108.133, ...
Connecting to objects.githubusercontent.com (objects.githubusercontent.com)|185.199.110.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 8888296 (8.5M) [application/octet-stream]
Saving to: ‘/usr/local/bin/nodectl’

nodectl 100%[==================================================>] 8.48M --.-KB/s in 0.09s

2023-05-01 20:16:12 (90.5 MB/s) - ‘/usr/local/bin/nodectl’ saved [8888296/8888296]

No installation found
Creating log directory for nodectl
VERSION     MAJOR     MINOR     PATCH
v2.15.2     2         13        0
ubuntu@ip-172-31-90-241:~$

In the example output 👆, an expected error is shown in bold (see explained).

p12 Migration

If you are coming from the New Node Installation with p12 Migration document (which shares elements of this document), you can return to that document now by clicking here; otherwise continue forward.

Explained

Following the command above will execute 3 commands synchronously (in order).

  1. It will attempt to disable the auto_restart feature of nodectl and fail. This is excepted behavior because we have not turned our VPS into a node yet. The combination of commands executed is intended for both new installations and upgrades, where the auto_restart feature may be engaged. The auto_restart feature cannot be running during an upgrade.
  2. It will utilize the wget utility; that comes preinstalled on most Debian based distributions, to download the nodectl binary from GitHub and place it in the correct location on your VPS for properly future use.
  3. It will then execute the version command.
  4. Prior to displaying the version for our review, since this is the first run of the nodectl utility, nodectl will automagically setup the logging mechanism. These log files can be useful when troubleshooting nodectl related issues, later on during normal operation.
  5. Finally, nodectl displays the version of nodectl, which will help us determine if the utility properly downloaded; as well as, at the desired version.

The username we are logged in with is also shown in bold (in the example above 👆 only - it will not be colored or highlighted on your real VPS output) to help us interpret the output correctly.