Skip to content
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Go to file
Cannot retrieve contributors at this time


AeroLab is a tool that creates Aerospike development and testing clusters in Docker or on AWS, streamlining efforts to test cluster configuration options, upgrade procedures, and client applications in a controlled development environment.

NOTE: AeroLab is intended for local development and testing environments. It is not recommended for production operations.


The releases page contains links to current installer packages for all the supported backends.

Operating System Package Notes
macOS aerolab-macos-* Native macOS binary, compiled for x86_64 and M series ARM chips
Linux aerolab-linux-* Native package for Linux (all x86_64 and ARM64 distros)
Windows aerolab-linux-* Install and start using WSL2 on Windows

Supported backends

  • Docker
    • on macOS
    • on Linux
    • on Windows
  • Podman (with the following command to enable: alias docker=podman)
  • AWS
  • GCP

Routing to the containers using other Docker solutions

Containers cannot be accessed directly by their IPs in certain Docker installations (specifically on macOS and Windows). To work around this, you can create a tunnel to a Docker container. Once a tunnel container is set up, you can access AeroLab containers directly. For example, if your Aerospike node is on port 3000, you can directly seed from that node on the desktop. This is particularly important when starting multi-node clusters, because client code on the desktop must be able to connect to all nodes.

See the tunnel container setup instructions for more information about setting up tunneling for direct container access.

You can see the IP addresses of running AeroLab containers with the aerolab cluster-list command.

Table of contents

Getting started

AeroLab on AWS

AeroLab on GCP

Help commands

Usage examples

Deploying clients


Utility scripts


See for version changes


See for latest stable version number