--- title: "Install Aerospike on Linux" description: "Learn how to install Aerospike Database on Linux (Debian, Ubuntu, RHEL) using tgz or package installers." --- # Install Aerospike on Linux > For the complete documentation index see: [llms.txt](https://aerospike.com/docs/llms.txt) > > All documentation pages available in markdown. This quickstart walks you through downloading, extracting, and installing Aerospike Database on Linux (Debian, Ubuntu, or RHEL). When you’re done, you’ll have Aerospike installed with an in-memory namespace, ready for development and testing. ::: note Mixed Linux distributions are supported within a cluster as long as each is an [Aerospike-supported version](https://aerospike.com/docs/database/reference/platform-support). However, for consistent performance and easier debugging, we recommend using the same OS version for all nodes. ::: ## Requirements Aerospike tools run on 64-bit Linux distributions, including Red Hat Enterprise Linux (RHEL) and its binary compatible variants, Ubuntu, Debian, Amazon Linux, and Oracle Linux. See [Platform support and compatibility](https://aerospike.com/docs/database/reference/platform-support/) for more information. ## Prerequisites ::: caution Aerospike Database is not supported on systems with [SELinux](https://www.redhat.com/en/topics/linux/what-is-selinux) in `Enforcing` mode. If you are using SELinux, it must be permanently disabled or permanently set to `Permissive` mode. See [the RHEL documentation](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/security-enhanced_linux/sect-security-enhanced_linux-working_with_selinux-changing_selinux_modes) for more information. ::: - [Debian](#tab-panel-2298) - [Ubuntu](#tab-panel-2299) - [RHEL](#tab-panel-2300) - To install, you must have root access or permission to run `sudo`. - Verify that you have the `libcurl4` package installed. - To install, you must have root access or permission to run `sudo`. - Verify that you have the `libcurl4` package installed. - [SELinux](https://www.redhat.com/en/topics/linux/what-is-selinux) must be permanently disabled or permanently set to `Permissive` mode. - To install, you must have root access or permission to run `sudo`. - Verify that you have the `libcurl` or `libcurl-minimal` package installed. - For RHEL 8 (Database 5.7.0+), “stripped-down” or non-standard OS versions must meet specific dependencies before installing Aerospike EE. See [CentOS 8 package dependencies](https://aerospike.com/docs/database/advanced/troubleshoot/install/#centos-8-package-dependencies). - Support for CentOS 7 was removed in Database 7.0.0. For CentOS, the Aerospike installation files are built with OpenSSL version 1.02. Aerospike will fail on earlier versions of OpenSSL. - Starting with Database 8.1.1, OpenSSL version 1.1.0 or later is required. ::: note Some RHEL 7 and RHEL 8 variants for 64-bit ARM have changed their default kernels to a 64K memory page size, and are therefore no longer supported. Aerospike users with deployments on these operating system versions must upgrade to one whose kernel has a 4K page size. Amazon Linux 2 and Amazon Linux 2023 for 64-bit ARM are safe. ::: ## Install Aerospike Database You can download the software from the [download page](https://aerospike.com/download), or download from the command line with the example URL in Step 1. We recommend that you read the [release notes](https://aerospike.com/docs/database/release) of the version you download. To learn about automating downloads from the artifact repository, see the [FAQ on downloads](https://aerospike.com/docs/database/reference/faq#download). 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. Download Aerospike Database. **Base URL:** ```txt 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](https://download.aerospike.com/artifacts/aerospike-server-enterprise/8.1.1/) and update the URL accordingly. ```text wget -O aerospike-server.tgz "https://download.aerospike.com/artifacts/aerospike-server-enterprise/8.1.1/aerospike-server-enterprise_8.1.1.2_tools-12.1.1_ubuntu24.04_x86_64.tgz" ``` 2. Extract the package. Terminal window ```bash tar -xvf aerospike-server.tgz ``` The contents are extracted to a directory named similarly to the package. The directory includes: - `license.txt` — licenses for Aerospike and other software included in the package - Tools package — [Aerospike command-line tools and utilities](https://aerospike.com/docs/database/tools) - Server package — the Aerospike Database package 3. Install the server and tools. Run from the extracted directory: Terminal window ```bash cd aerospike-server-enterprise-* sudo ./asinstall ``` For a description of files and directories that are installed, see [Directory structure](https://aerospike.com/docs/database/manage/database/directory-structure). Alternatively, install the Debian or RPM packages directly: - [Debian](#tab-panel-2301) - [Ubuntu](#tab-panel-2302) - [RHEL](#tab-panel-2303) Terminal window ```bash sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb sudo dpkg -i aerospike-tools_version-distro_architecture.deb ``` Terminal window ```bash sudo dpkg -i aerospike-server-edition_version-1distro_architecture.deb sudo dpkg -i aerospike-tools_version-distro_architecture.deb ``` Terminal window ```bash sudo rpm -Uvh aerospike-server-edition_version-1distro_architecture.rpm sudo rpm -Uvh aerospike-tools_version-distro_architecture.rpm ``` ## Next steps The Aerospike-included init script `/etc/init.d/aerospike` manages the Aerospike Database Daemon `/usr/bin/asd`. In addition, the Aerospike database can be controlled with standard `systemctl` commands. For details, see [Aerospike Daemon Management](https://aerospike.com/docs/database/manage/database/daemon). ### Configure Aerospike Installation establishes the server’s default configuration. An in-memory test namespace is configured by default. See [Configure Aerospike Database](https://aerospike.com/docs/database/manage/database/as-config) to modify and tune the configuration. ### Add devices and more To add [SSDs](https://aerospike.com/docs/database/manage/planning/ssd), see [setup](https://aerospike.com/docs/database/manage/planning/ssd/setup) and [initialization](https://aerospike.com/docs/database/manage/planning/ssd/manage). ### Configure EE feature-key file Aerospike EE requires a [feature-key file](https://aerospike.com/docs/database/manage/planning/feature-key) to start up and enable gated features, such as compression. ::: note Starting with Database 6.1.0, the feature-key file for a single-node cluster is provided, so the server will start up automatically. ::: ### Configure logging To configure logging for the Aerospike database, see [Log management](https://aerospike.com/docs/database/manage/logging/logs).