Install Aerospike Backup Control (absctl)

Choose your installation method depending on your system.

Pre-built binaries

Download pre-built binaries from GitHub Releases. Select your platform and architecture:

Linux x86_64

# Download
wget https://github.com/aerospike/absctl/releases/download/v1.0.0-1/absctl-1.0.0-1.x86_64.rpm

# Install (RHEL/CentOS/Fedora)
sudo rpm -i absctl-1.0.0-1-1.x86_64.rpm

Linux aarch64

# Download
wget https://github.com/aerospike/absctl/releases/download/v1.0.0-1/absctl-1.0.0-1.aarch64.rpm

# Install (RHEL/CentOS/Fedora)
sudo rpm -i absctl-1.0.0-1-1.aarch64.rpm

macOS arm64

# Download
curl -LO https://github.com/aerospike/absctl/releases/download/v1.0.0-1/absctl-1.0.0-1-Darwin-arm64.tar.gz

# Extract
tar -xzvf absctl-1.0.0-1-Darwin-arm64.tar.gz

# Make executable and move to PATH
chmod +x absctl
sudo mv absctl /usr/local/bin/

macOS x86_64

# Download
curl -LO https://github.com/aerospike/absctl/releases/download/v1.0.0-1/absctl-1.0.0-1-Darwin-x86_64.tar.gz

# Extract
tar -xzvf absctl-1.0.0-1-Darwin-x86_64.tar.gz

# Make executable and move to PATH
chmod +x absctl
sudo mv absctl /usr/local/bin/

Docker

Run absctl from a Docker container without installing locally.

docker run -it --rm \
-v ./data:/data/backup \
aerospike.jfrog.io/ecosystem-container-preview-public-local/absctl:v1.0.0-1 \
absctl --help

See the quick start for a complete Docker example.

Build from source

Build absctl from source when you need custom modifications or the latest development version.

1. Clone the absctl GitHub repository.

   git clone https://github.com/aerospike/absctl.git

2. Navigate to the repository root.

   cd absctl

3. Build the binary.

   make build

4. Optionally, build .rpm and .deb packages for supported Linux architectures (linux/amd64, linux/arm64).

   make packages

   The generated packages and their sha256 checksum files appear in the /target directory.

Get started

• Follow the absctl quick start to test out the tools.
• For backup instructions, see Backup (absctl backup).
• For restore instructions, see Restore (absctl restore).
• For Secret Agent integration, see Secret usage with backup and restore.