Install on Google Compute Engine

This quickstart walks you through creating a Google Compute Engine 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.

Note

Aerospike’s Community Edition is configured to transmit anonymous usage statistics. We ask your help in making Aerospike better by leaving this feature enabled. See Aerospike telemetry to learn about our goals, how we use the data, and how to disable the feature

Prerequisites

• Root access or permission to run sudo.
• Verify that you have the version of libcurl that goes with your Database version. Ubuntu 22.04 and 24.04 use libcurl4.
• Aerospike is compatible with OpenSSL 3, supporting Ubuntu 22.04 and 24.04 LTS.

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.

   Note

   Google Compute Engine has a quota limit of 8 CPU cores for the free trial. We suggest that you request a quota increase for your project.

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

   Option	Value
   Name	aerospike-server
   Zone	us-central-1f (choose a zone geographically close to your location)
   Machine Type	n1-standard-2
   Boot Source	New disk from image
   Image	Ubuntu 24.04 LTS
   Boot disk	Standard 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-3004
   • Create another rule for the Aerospike Management Console:
     • Name: Aerospike Management Console
     • Source IP Ranges: 0.0.0.0/0
     • Protocols and Ports: tcp:8081

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

Install Aerospike Database

You can download the software from the download page, or download from the command line with the example URL in Step 1.

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. The following command is an example only. Choose the edition and version from the artifact index and update the URL accordingly.

   apt-get update
   wget -O aerospike-server.tgz "https://download.aerospike.com/artifacts/aerospike-server-enterprise/8.1.1.0/aerospike-server-enterprise_8.1.1.0_tools-12.1.1_ubuntu24.04_x86_64.tgz"

2. Extract and install.

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

3. Start Aerospike.

   sudo service aerospike start

Next steps

• See Network configuration to form a cluster.
• Configure storage to persist data: Configure namespace storage.