# 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](https://aerospike.com/docs/database/tools/voyager/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](https://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](https://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](https://aerospike.com/download/voyager/), then install it as described below.

### Debian / Ubuntu

Terminal window

```bash
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

Terminal window

```bash
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](https://aerospike.com/docs/database/tools/voyager/quickstart)