Install Voyager

This page covers how to install, update, and uninstall Aerospike Voyager.

Prerequisites

• An Aerospike cluster to connect to. This can be a local instance running in Docker or a remote cluster. See the Quickstart for a Docker one-liner if you do not have a cluster yet.
• A supported operating system:
  • macOS 12 (Monterey) or later (Apple Silicon or Intel)
  • Windows 10 or later (64-bit)
  • Linux: Ubuntu 20.04+, Fedora 36+, or equivalent (x86_64 or arm64)

macOS

1. Download the .dmg file from aerospike.com/download/voyager.
2. Open the .dmg and drag Voyager into the Applications folder.
3. Launch Voyager from Applications.

Note

On first launch, macOS Gatekeeper may display a warning because Voyager is downloaded from the internet. Click Open to proceed. If macOS blocks the app, go to System Settings > Privacy & Security and click Open Anyway.

Windows

1. Download the .exe installer from aerospike.com/download/voyager.
2. Run the installer and follow the prompts.
3. Launch Voyager from the Start menu or desktop shortcut.

Caution

Windows code signing is not yet implemented for the Preview release. You will see a Windows SmartScreen warning when launching Voyager for the first time. Click More info and then Run anyway to proceed.

Linux

Voyager ships as .deb and .rpm packages for both x86_64 and arm64 architectures. Download the package that matches your distribution and architecture from aerospike.com/download/voyager, then install it as described below.

Debian / Ubuntu

sudo dpkg -i aerospike-voyager_<version>_<arch>.deb
sudo apt -f install

The apt -f install step pulls in any missing dependencies.

RHEL / CentOS / Fedora

sudo dnf install ./aerospike-voyager-<version>.<arch>.rpm

On older distributions, replace dnf with yum.

After installation, launch Voyager from your desktop application menu.

First launch

On first launch, accept the license agreement and select your usage-statistics preference to reach the Welcome page.

Auto-updates

Voyager checks for updates automatically on launch. When an update is available, Voyager prompts you to install it.

Manage auto-checks and run a manual check from Preferences → Software updates (toggle Auto-check for updates or click Check now).

Factory reset

To reset Voyager to its default state (removing all saved connections, preferences, and MCP tokens), go to Settings > Advanced and click Factory Reset. This action cannot be undone.

Uninstall

macOS

1. Quit Voyager.
2. Drag Voyager from the Applications folder to the Trash.
3. Optionally, remove the data directory at ~/Library/Application Support/voyager.

Windows

1. Quit Voyager.
2. Open Settings > Apps > Installed apps, find Voyager, and click Uninstall.
3. Optionally, remove the data directory at %APPDATA%\voyager.

Linux

1. Quit Voyager.
2. Remove the package:
   • Debian / Ubuntu: sudo apt remove aerospike-voyager
   • RHEL / CentOS / Fedora: sudo dnf remove aerospike-voyager (or sudo yum remove aerospike-voyager on older distributions)
3. Optionally, remove the data directory at $XDG_DATA_HOME/voyager.

Next steps

• Quickstart: explore data in 10 minutes