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).
If your system uses the apt
package manager, you can install Hyperdrive by enabling our repository.
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.
Update the system packages and install some prerequisites:
sudo apt update && sudo apt install curl gnupg apt-transport-https ca-certificates
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
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
Install Hyperdrive via apt
:
sudo apt update && sudo apt install hyperdrive
If you can't or don't want to use the apt
process, you can install Hyperdrive manually instead.
- 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.
- Install Hyperdrive via the CLI:
hyperdrive service install
This will also handle installing all of the dependencies and permissions for you.