Skip to content

Install on Google Compute Engine

For the complete documentation index see: llms.txt

All documentation pages available in markdown.

This page describes how to install Aerospike Database on Google Compute Engine by creating a VM, configuring firewall rules, and installing Aerospike Database on Ubuntu. When you’re done, you’ll have a single-node Aerospike cluster running with an in-memory namespace, ready for development and testing.

Prerequisites

  • Root access or permission to run sudo.
  • Verify that you have the libcurl4t64 package installed.
  • Choose an Ubuntu LTS release that your Database version supports. Database 8.2.0 supports Ubuntu 26.04 and 24.04, and Ubuntu 26.04 requires Database 8.2.0 or later. See Platform support and compatibility for the full matrix.
  • Aerospike’s OpenSSL compatibility varies by Database release. See Transport Layer Security for the version supported by each release.

Create and configure your GCP VM

  1. Sign in to Google Cloud Platform. If you have not already signed up, create an account.

  2. Open the Google Cloud Console at https://console.cloud.google.com/ and select or create a Project.

  3. Create a VM instance. On the Project Dashboard, click Create Instance and use the following options:

    OptionValue
    Nameaerospike-server
    Zoneus-central1-f (choose a zone geographically close to your location)
    Machine Typen2-standard-4
    Boot SourceNew disk from image
    ImageUbuntu 24.04 LTS
    Boot diskStandard persistent disk

    Use defaults for other options and click Create. Your instance should be listed in about a minute.

  4. Configure firewall rules. On the instance page, click the default link under the Network section.

    • Under Firewall Rules, click Create New.
    • Create a rule for the Aerospike server:
      • Name: Aerospike server
      • Source IP Ranges: 0.0.0.0/0
      • Protocols and ports: tcp:3000 is open to clients, 3001-3002 to other cluster nodes, 3003 is admin.

  5. Connect to your instance. Click SSH to connect using the browser or the gcloud command line tool.

Install Aerospike Database

You can download Aerospike Database from the download page, or download from the command line with the example URL in the following install steps.

We recommend that you read the release notes of the version you download.

To learn about automating downloads from the artifact repository, see the FAQ on downloads.

Aerospike Community, Enterprise, and Federal editions are available for all supported Linux distributions, and use the following naming convention: aerospike-server-EDITION_VERSION_tools-TOOLS-VERSION_DISTRO_ARCHITECTURE.tgz

  1. Update packages and download Aerospike.

    Base URL:

    https://download.aerospike.com/artifacts/aerospike-server-edition/server-version/

    Example download command. Choose the edition and version from the artifact index and update the URL in your command accordingly.

    Terminal window
    apt-get update
    wget -O aerospike-server.tgz "https://download.aerospike.com/artifacts/aerospike-server-enterprise/8.2.0/aerospike-server-enterprise_8.2.0.0_tools-13.0.3_ubuntu26.04_x86_64.tgz"

  2. Extract and install.

    Terminal window
    tar -xvf aerospike-server.tgz
    cd aerospike-server-enterprise-*
    sudo ./asinstall

  3. Start Aerospike.

    Terminal window
    sudo service aerospike start

Next steps