{
  "schema_version": 2,
  "id": "operate/rs/installing-upgrading/install/install-on-linux",
  "title": "Install Redis Software on Linux",
  "url": "https://redis.io/docs/latest/operate/rs/installing-upgrading/install/install-on-linux/",
  "summary": "Install Redis Software on Linux.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-09-24T09:16:34+01:00",
  "page_type": "content",
  "content_hash": "6b78930309ac178409d2d3594eb70561ed1bf94be92e3da4561ec4620fd265c5",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "After you [download a Redis Software installation package](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/prepare-install/download-install-package), install it on one of the nodes in the cluster.\n\nFor installation on machines without an internet connection, see [Offline installation](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/offline-installation)."
    },
    {
      "id": "install-on-linux",
      "title": "Install on Linux",
      "role": "setup",
      "text": "To install Redis Software, use the command line:\n\n1. Copy the installation package to the node.\n\n1. On the node, change to the directory where the installation package is located and extract the installation files:\n\n    [code example]\n\n1.  _(Optional)_ Use the  to confirm the authenticity of Ubuntu/Debian or RHEL RPM packages:\n\n    - For Ubuntu:\n        1. Import the key:\n        [code example]\n        2. Verify the package signature:\n        [code example]\n\n    - For RHEL:\n        1. Import the key:\n        [code example]\n        2. Verify the package signature:\n         [code example]\n\n1. To start the installation process, run the installation script. See [installation script options](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/install-script) for a complete list of command-line options.\n\n    **For default installation:**\n    [code example]\n\n    **For custom installation directories:**\n\n    If you need to specify custom storage paths for persistent or ephemeral storage during cluster setup, you must install Redis Software to custom directories.\n\n    [code example]\n\n    For detailed information about custom installations, see [Customize installation directories](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/customize-install-directories).\n\n    > [!NOTE]\n    > - The Redis Software files are installed in the default [file locations](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/file-locations) unless you specify custom directories.\n    > - By default, Redis Software runs on the OS as the `redislabs` user and `redislabs` group. If needed, you can [specify a different user and group](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/customize-user-and-group) during the installation.\n    > - You must either be the root user or use `sudo` to run the installation script.\n\n1. Answer the [installation questions](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/manage-installation-questions) when shown to complete the installation process.\n\n    > [!NOTE]\n    > To skip the installation questions, use one of the following methods:\n    >\n    > - Run `./install.sh -y` to answer yes to all of the questions.\n    > - Create an [answer file](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/manage-installation-questions#configure-file-to-answer) to answer installation questions automatically.\n\n1. When installation completes successfully, the output displays the Cluster Manager UI's IP address:\n\n    [code example]\n\n1. Repeat this process for each node in the cluster."
    },
    {
      "id": "redis-flex-and-auto-tiering-installation",
      "title": "Redis Flex and Auto Tiering installation",
      "role": "content",
      "text": "If you want to use Redis Flex or Auto Tiering for your databases, review the prerequisites, storage requirements, and [other considerations](https://redis.io/docs/latest/operate/rs/databases/flash) and prepare and format the flash memory.\n\nAfter you install Redis Software, use the `prepare_flash` script to prepare and format flash memory:\n\n[code example]\n\nThis script finds unformatted disks and mounts them as RAID partitions in `/var/opt/redislabs/flash`.\n\nTo verify the disk configuration, run:\n\n[code example]"
    },
    {
      "id": "more-info-and-options",
      "title": "More info and options",
      "role": "content",
      "text": "To learn more about customization and find answers to related questions, see:\n\n- [CentOS/RHEL firewall configuration](https://redis.io/docs/latest/operate/rs/installing-upgrading/configuring/centos-rhel-firewall)\n- [Change socket file location](https://redis.io/docs/latest/operate/rs/installing-upgrading/configuring/change-location-socket-files)\n- [Cluster DNS configuration](https://redis.io/docs/latest/operate/rs/networking/cluster-dns)\n- [Cluster load balancer setup](https://redis.io/docs/latest/operate/rs/networking/cluster-lba-setup)\n- [mDNS client prerequisites](https://redis.io/docs/latest/operate/rs/networking/mdns)\n- [File locations](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/file-locations)\n- [Supported platforms](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/supported-platforms)"
    },
    {
      "id": "limitations",
      "title": "Limitations",
      "role": "limits",
      "text": "Several Redis Software installation reference files are installed to the directory `/etc/opt/redislabs/` even if you use [custom installation directories](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/customize-install-directories).\n\nAs a workaround to install Redis Software without using any root directories, do the following before installing Redis Software:\n\n1. Create all custom, non-root directories you want to use with Redis Software.\n\n1. Mount `/etc/opt/redislabs` to one of the custom, non-root directories."
    },
    {
      "id": "next-steps",
      "title": "Next steps",
      "role": "content",
      "text": "1. [Create](https://redis.io/docs/latest/operate/rs/clusters/new-cluster-setup)\n    or [join](https://redis.io/docs/latest/operate/rs/clusters/add-node) an existing Redis Software cluster.\n\n1. [Create a database](https://redis.io/docs/latest/operate/rs/databases/create).\n\n    For geo-distributed Active-Active replication, create an [Active-Active](https://redis.io/docs/latest/operate/rs/databases/active-active/create) database.\n\n1. [Add users](https://redis.io/docs/latest/operate/rs/security/access-control/create-users) to the cluster with specific permissions.  To begin, start with [Access control](https://redis.io/docs/latest/operate/rs/security/access-control)."
    }
  ],
  "examples": [
    {
      "id": "install-on-linux-ex0",
      "language": "sh",
      "code": "tar vxf <tarfile name>",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex1",
      "language": "sh",
      "code": "gpg --import <path to GPG key>",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex2",
      "language": "sh",
      "code": "dpkg-sig --verify </path-to/package.deb>",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex3",
      "language": "sh",
      "code": "rpm --import <path to GPG key>",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex4",
      "language": "sh",
      "code": "rpm --checksig </path-to/package.rpm>",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex5",
      "language": "sh",
      "code": "sudo ./install.sh",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex6",
      "language": "sh",
      "code": "sudo ./install.sh --install-dir <path> --config-dir <path> --var-dir <path>",
      "section_id": "install-on-linux"
    },
    {
      "id": "install-on-linux-ex7",
      "language": "sh",
      "code": "Summary:\n    -------\n    ALL TESTS PASSED.\n    2017-04-24 10:54:15 [!] Please logout and login again to make\n    sure all environment changes are applied.\n    2017-04-24 10:54:15 [!] Point your browser at the following\n    URL to continue:\n    2017-04-24 10:54:15 [!] https://<your_ip_here>:8443",
      "section_id": "install-on-linux"
    },
    {
      "id": "redis-flex-and-auto-tiering-installation-ex0",
      "language": "sh",
      "code": "sudo /opt/redislabs/sbin/prepare_flash.sh",
      "section_id": "redis-flex-and-auto-tiering-installation"
    },
    {
      "id": "redis-flex-and-auto-tiering-installation-ex1",
      "language": "sh",
      "code": "sudo lsblk",
      "section_id": "redis-flex-and-auto-tiering-installation"
    }
  ]
}