{
  "id": "install-on-linux",
  "title": "Install Redis Software on Linux",
  "url": "https://redis.io/docs/latest/operate/rs/8.0/installing-upgrading/install/install-on-linux/",
  "summary": "Install Redis Software on Linux.",
  "content": "\nAfter 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).\n\n## Install on Linux\n\nTo 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    ```sh\n    tar vxf \u003ctarfile name\u003e\n    ```\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        ```sh\n        gpg --import \u003cpath to GPG key\u003e\n        ```\n        2. Verify the package signature:\n        ```sh\n        dpkg-sig --verify \u003c/path-to/package.deb\u003e\n        ```\n\n    - For RHEL:\n        1. Import the key:\n        ```sh\n        rpm --import \u003cpath to GPG key\u003e\n        ```\n        2. Verify the package signature:\n         ```sh\n         rpm --checksig \u003c/path-to/package.rpm\u003e\n         ```\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    ```sh\n    sudo ./install.sh\n    ```\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    ```sh\n    sudo ./install.sh --install-dir \u003cpath\u003e --config-dir \u003cpath\u003e --var-dir \u003cpath\u003e\n    ```\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    \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.md) 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.md) during the installation.\n- You must either be the root user or use `sudo` to run the installation script.\n    \n\n1. Answer the [installation questions](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/manage-installation-questions.md) when shown to complete the installation process.\n\n    \nTo 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    \n\n1. When installation completes successfully, the output displays the Cluster Manager UI's IP address:\n\n    ```sh\n    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://\u003cyour_ip_here\u003e:8443\n    ```\n\n1. Repeat this process for each node in the cluster.\n\n\n## Redis Flex and Auto Tiering installation\n\nIf 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```sh\nsudo /opt/redislabs/sbin/prepare_flash.sh\n```\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```sh\nsudo lsblk\n```\n\n## More info and options\n\nTo 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.md)\n- [Change socket file location](https://redis.io/docs/latest/operate/rs/installing-upgrading/configuring/change-location-socket-files.md)\n- [Cluster DNS configuration](https://redis.io/docs/latest/operate/rs/networking/cluster-dns.md)\n- [Cluster load balancer setup](https://redis.io/docs/latest/operate/rs/networking/cluster-lba-setup.md)\n- [mDNS client prerequisites](https://redis.io/docs/latest/operate/rs/networking/mdns.md)\n- [File locations](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/file-locations.md)\n- [Supported platforms](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/plan-deployment/supported-platforms.md)\n\n## Limitations\n\nSeveral 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.\n\n## Next steps\n\n1. [Create](https://redis.io/docs/latest/operate/rs/clusters/new-cluster-setup.md)\n    or [join](https://redis.io/docs/latest/operate/rs/clusters/add-node.md) 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.md) 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).\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-07-23T12:05:56-05:00"
}