Hyperdrive

Hyperdrive is an all-in-one node management system for NodeSet node operators.

Check the NodeSet docs pages for full documentation and setup guides.

Installation

Installing Hyperdrive can be done in two ways: via the apt package manager for Debian-based systems, or manually via the CLI (for any Linux or macOS system).

Via the Package Manager (for Debian-based systems with apt)

If your system uses the apt package manager, you can install Hyperdrive by enabling our repository.

Install Docker

Start by installing Docker for your system following the Docker installation instructions.

Next, add your user to the group of Docker administrators:

sudo usermod -aG docker $USER

Finally, exit the terminal session and start a new one (log out and back in or close and re-open SSH) for the new permissions to take effect.

Install Hyperdrive

1. Update the system packages and install some prerequisites:

   sudo apt update && sudo apt install curl gnupg apt-transport-https ca-certificates
   

2. Save the Hyperdrive repository signing key:

   sudo install -m 0755 -d /etc/apt/keyrings && sudo curl -fsSL https://packagecloud.io/nodeset/hyperdrive/gpgkey -o /etc/apt/keyrings/hyperdrive.asc
   

3. Add the Hyperdrive repository to your apt list:

   sudo tee -a /etc/apt/sources.list.d/hyperdrive.list << EOF
   deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/hyperdrive.asc] https://packagecloud.io/nodeset/hyperdrive/any/ any main
   deb-src [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/hyperdrive.asc] https://packagecloud.io/nodeset/hyperdrive/any/ any main
   EOF
   

4. Install Hyperdrive via apt:

   sudo apt update && sudo apt install hyperdrive
   

Manual Install (for all systems)

If you can't or don't want to use the apt process, you can install Hyperdrive manually instead.

1. Download the CLI from the latest GitHub release. Note there are four options: two for Linux and two for Darwin (macOS); both are available for amd64 and arm64. To have parity with the package installer, we recommend saving it to /usr/bin/hyperdrive. For example, on an x64 Linux system, you could do:

   sudo wget https://github.com/nodeset-org/hyperdrive/releases/latest/download/hyperdrive-cli-linux-amd64 -O /usr/bin/hyperdrive && sudo chmod +x /usr/bin/hyperdrive
   

   Make sure you run chmod +x on it before trying to use it.

2. Install Hyperdrive via the CLI:

   hyperdrive service install
   

This will also handle installing all of the dependencies and permissions for you.

Updating Hyperdrive

Via the Package Manager (for Debian-based systems with apt)

If you installed Hyperdrive via the package manager, you simply need to run the following to update it when a new release is out (along with any other system packages that are out of date):

sudo apt update && sudo apt dist-upgrade && sudo apt auto-remove

Manual Update (for all systems)

If you installed Hyperdrive manually, start by downloading the new CLI using the same process you followed in step 1 of the manual installation section.

Once it's downloaded, run the following command:

hyperdrive service install -d

Note the -d which skips Operating System dependencies, since you already have them.

Contributions

Contributions are welcomed! Please see CONTRIBUTING.md for more details.

Attribution and License History

Early versions were adapted from the Rocket Pool Smart Node.

As of 2024, Hyperdrive is entirely based on work from NodeSet, Inc and community contributors.

In 2026, this repository was relicensed from AGPLv3 to MIT. The main reason for this change is to allow everyone to use and modify Hyperdrive without any requirement to publicly share their changes. Notably, this is important for NodeSet operators who operate as a business instead of as an individual that may have security concerns with publicizing their changes, since the AGPLv3 license already allowed for individuals to modify for private personal use without sharing.