{
  "id": "redis-enterprise-software-quickstart",
  "title": "Redis Software quickstart",
  "url": "https://redis.io/docs/latest/operate/rs/8.0/installing-upgrading/quickstarts/redis-enterprise-software-quickstart/",
  "summary": "Set up a test deployment of Redis Software for Linux.",
  "content": "This guide helps you install Redis Software on a Linux host to test its capabilities.\n\nWhen finished, you'll have a simple cluster with a single node:\n\n1. [Ensure port availability](#ensure-port-availability)\n\n1. [Install Redis Software](#install-redis-enterprise-software)\n\n1. [Set up a Redis Software cluster](#set-up-a-cluster)\n\n1. [Create a new Redis database](#create-a-database)\n\n1. [Connect to your Redis database](#connect-to-your-database)\n\n\n**This quickstart is designed for local testing only.**\nFor production environments, see the [install and setup](https://redis.io/docs/latest/operate/rs/installing-upgrading#install-redis-enterprise-software) guide for deployment options and instructions.\n\n\n## Ensure port availability\n\nIf ports that Redis assigns to the database are being used by the operating system or other processes, the installation fails.\n\nFollow the relevant sections to configure required ports.\n\nFor recommended and optional port configuration, see [Network port configurations](https://redis.io/docs/latest/operate/rs/networking/port-configurations).\n\n### Update `sysctl.conf` to avoid port collisions\n\nTo avoid port collision, update `/etc/sysctl.conf` to include:\n\n``` sh\nnet.ipv4.ip_local_port_range = 30000 65535\n```\n\n\n### OS conflicts with port 53\n\nIf port 53 is in use, the installation fails. This issue can occur in default installations of certain operating systems in which `systemd-resolved` (DNS server) or `dnsmasq` is running.\n\nTo prevent this issue, change the system configuration to make this port available before installation.\n\nTo prevent `systemd-resolved` from using port 53:\n\n1. Edit `/etc/systemd/resolved.conf`: \n\n    ```sh\n    sudo vi /etc/systemd/resolved.conf\n    ```\n\n1. Add `DNSStubListener=no` as the last line in the file and save the file.\n\n1. Rename the current `/etc/resolv.conf` file:\n\n    ```sh\n    sudo mv /etc/resolv.conf /etc/resolv.conf.orig\n    ```\n\n1. Create a symbolic link for `/etc/resolv.conf`:\n\n    ```sh\n    sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf\n    ```\n\n    \nYou might encounter a temporary name resolution error (`sudo: unable to resolve host {hostname}: Temporary failure in name resolution`), which should be fixed when you restart `systemd-resolved` in the next step.\n    \n\n2. Restart the DNS service:\n\n    ```sh\n    sudo service systemd-resolved restart\n    ```\n\nTo prevent `dnsmasq` from using port 53:\n\n1. Stop the `dnsmasq` service if it's running:\n\n    ```sh\n    sudo systemctl stop dnsmasq\n    ```\n\n1. Prevent `dnsmasq` from starting automatically at system boot:\n\n    ```sh\n    sudo systemctl disable dnsmasq\n    ```\n\n1. Mask `dnsmasq` to prevent it from being started manually or by other services:\n\n    ```sh\n    sudo systemctl mask dnsmasq\n    ```\n\n1. Verify `dnsmasq` is no longer active and won't start at system boot:\n\n    ```sh\n    sudo systemctl status dnsmasq\n    ```\n\n\n\n### Configuration for AWS and GCP\n\nFor detailed configuration instructions, see your cloud provider's documentation.\n\n1. Create a VPC that you can use with regional subnets.\n\n1. Within this VPC, create firewall rules that allow external and internal access for Redis Software.\n\n\n| Ingress/Egress   | Source                                             | Protocol  | Ports                                    | Other protocols  |\n|------------------|----------------------------------------------------|-----------|------------------------------------------|------------------|\n| Ingress          | 0.0.0.0/0                                          | TCP       | 21, 22, 53, 8001, 8443, 9443, 8070, \u003cnobr\u003e10000-19999\u003c/nobr\u003e | ICMP             |\n| Ingress          | 0.0.0.0/0                                          | UDP       | 53, 5353                                  |                  |\n| Ingress          | 10.0.0.0/8  (if subnets use 10. ranges) | all       | all                                      |                  | \n\n\n## Install Redis Software\n\nTo install Redis Software:\n\n1. Download the installation files from the [Redis Software Download Center](https://redis.io/downloads/#Redis_Software)\nand copy the download package to a machine with a Linux-based OS. \n\n    \nYou are required to create a free account to access the download center.\n    \n\n1. Extract the installation files:\n\n    ```sh\n    tar vxf \u003cdownloaded tar file name\u003e\n    ```\n\n1. Run the `install.sh` script in the current directory:\n\n    ```sh\n    sudo ./install.sh -y\n    ```\n\n## Set up a cluster\n\nTo set up your machine as a Redis Software cluster:\n\n1. In a browser, go to `https://\u003cname-or-IP-address-of-the-machine-with-Redis-Enterprise-Software-installed\u003e:8443` to access the Cluster Manager UI. If you use a browser on the host machine, you can also access the Cluster Manager UI at `https://localhost:8443`.\n\n    The cluster generates self-signed TLS certificates to secure the connection. Because these self-signed certificates are unknown to the browser, you must accept them before you proceed.\n\n    If the server does not show the sign-in screen, try again after a few minutes.\n\n1. Select **Create new cluster**.\n\n    ![images/rs/screenshots/cluster/setup/create-cluster.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/create-cluster.png)\n\n2. Enter an email and password for the administrator account, then select **Next** to proceed to cluster setup.\n\n    ![images/rs/screenshots/cluster/setup/admin-credentials.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/admin-credentials.png)\n\n    You can also use these credentials to connect to the [REST API](https://redis.io/docs/latest/operate/rs/references/rest-api).\n\n3. Enter your cluster license key if you have one. Otherwise, a trial version is installed.\n\n    ![images/rs/screenshots/cluster/setup/cluster-license-key.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/cluster-license-key.png)\n\n4. In the **Configuration** section, enter a cluster FQDN such as `cluster.local`, then select **Next**.\n\n    ![images/rs/screenshots/cluster/setup/config-cluster.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/config-cluster.png)\n\n    \nIf the FQDN is `cluster.local`, you cannot configure DNS. You cannot change the FQDN after cluster creation.\n    \n\n1. On the node setup screen, select **Create cluster** to accept the defaults.\n\n    ![images/rs/screenshots/cluster/setup/node-settings.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/node-settings.png)\n\n6. Select **OK** to acknowledge the replacement of the HTTPS TLS certificate on the node.  If you receive a browser warning, you can proceed safely.\n\n    ![images/rs/screenshots/cluster/setup/https-page-refresh-modal.png](https://redis.io/docs/latest/images/rs/screenshots/cluster/setup/https-page-refresh-modal.png)\n\n\n## Create a database\n\n1. On the **Databases** screen, select **Quick database**.\n\n    ![images/rs/screenshots/databases/db-screen.png](https://redis.io/docs/latest/images/rs/screenshots/databases/db-screen.png)\n\n1. Enter 12000 for the **Port**.\n\n    If port 12000 is not available, enter any available port number between 10000 to 19999 or leave it blank to let the cluster assign a port number for you. You will use this port number to connect to the database.\n\n    ![images/rs/screenshots/databases/quick-db-7-8-2.png](https://redis.io/docs/latest/images/rs/screenshots/databases/quick-db-7-8-2.png)\n\n1. Select **Create** to create your database.\n\nWhen you see **Database active** appear on the database configuration screen, the database is activated and ready for you to use.\n\n![images/rs/icons/db-active-icon.png](https://redis.io/docs/latest/images/rs/icons/db-active-icon.png)\n\n\nYou now have a Redis database!\n\n## Connect to your database\n\nAfter you create the Redis database, you can connect to it and store data.\nSee [Test client connection](https://redis.io/docs/latest/operate/rs/databases/connect/test-client-connectivity) for connection options and examples.\n\n## Supported web browsers\n\nTo use the Redis Software Cluster Manager UI, you need a modern browser with JavaScript enabled.\n \nThe Cluster Manager UI is officially supported for the latest version of [Google Chrome](https://www.google.com/chrome/), as well as the three previous and three subsequent versions.\n\n## Continue learning with Redis University\n\n\n\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-07-23T15:55:14+01:00"
}