Redis Sentinel (cluster)

Deploy Redis as a Redis Sentinel cluster for high availability. Redis is an open source in-memory data store used as a key-value database, cache, and message broker.

📘

Cluster deployment

The app is deployed with three or five Linode instances to create a highly available Redis cluster, each with the plan type and size you select.

Each of these Linode instances will appear on your invoice as separate items. To deploy Redis on a single instance, see the Redis guide.

1. Deploy Redis Sentinel cluster

 Estimated deployment time: 15-30 minutes

Base distribution and plan

• Supported distribution: Ubuntu 24.04 LTS
• Recommended plans:
  • All plan types and sizes can be used.
  • For larger databases in a production environment, use a High Memory Compute Instance.

Configuration options

StackScript ID: 1132204

Note: After the app deployment completes, the password for your limited sudo user is generated and stored in the .deployment-secrets.txt file in the home directory, along with Redis credentials. Log in to your instance as root through the Lish console or SSH, then run cat /home/$USERNAME/.deployment-secrets.txt to view its contents.

Use API, CLI, or Terraform

curl --location 'https://api.linode.com/v4/linode/instances' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer abc123def456hij789klm' \
  --data-raw '{
    "region": "us-east",
    "type": "g6-standard-4",
    "image": "linode/ubuntu24.04",
    "label": "my-redis-sentinel-cluster-one-click-app",
    "root_pass": "@C0mpl3x#P@ssw0rd",
    "stackscript_id": 1132204,
    "stackscript_data": {
      "token_password": "abc123def456hij789klm",
      "sudo_username": "jsmith",
      "country_name": "US",
      "state_or_province_name": "Massachusetts",
      "locality_name": "Cambridge",
      "organization_name": "Akamai Technologies",
      "email_address": "jsmith@example.com"
    }
  }'

linode-cli linodes create \
  --region us-east \
  --type g6-standard-4 \
  --label my-redis-sentinel-cluster-one-click-app \
  --image linode/ubuntu24.04 \
  --root_pass @C0mpl3x#P@ssw0rd \
  --stackscript_id 1132204 \
  --stackscript_data '{"token_password":"abc123def456hij789klm", "sudo_username":"jsmith", "country_name":"US", "state_or_province_name":"Massachusetts", "locality_name":"Cambridge", "organization_name":"Akamai Technologies", "email_address":"jsmith@example.com"}'

resource "linode_instance" "my-linode" {
  region         = "us-east"
  type           = "g6-standard-4"
  label          = "my-redis-sentinel-cluster-one-click-app"
  image          = "linode/ubuntu24.04"
  root_pass      = "@C0mpl3x#P@ssw0rd"
  stackscript_id = 1132204
  stackscript_data = {
    "token_password"         = "abc123def456hij789klm"
    "sudo_username"          = "jsmith"
    "country_name"           = "US"
    "state_or_province_name" = "Massachusetts"
    "locality_name"          = "Cambridge"
    "organization_name"      = "Akamai Technologies"
    "email_address"          = "jsmith@example.com"
  }
}

2. Access the Redis CLI

1. Log in to your instance through the Lish console or SSH using either the root user or limited user and the associated password you entered when creating the instance.

2. To use redis-cli, run either of these commands:

   • redis-cli: This opens an interactive mode where you can type in whichever commands you want.
   • redis-cli [argument], where [argument] is the argument or command you want to run. For example, running redis-cli ping should output PONG if Redis is configured properly.

For more information about redis-cli and the available commands, see redis-cli and the Redis command line interface.

Additional resources

You can use several Redis configuration types. For example, you can configure Redis as a standalone Redis installation or a Redis cluster with a primary (master) and two replicas.

As a next step, you should determine which type of deployment you require for your use case by reviewing these resources:

• Learn about Redis clusters by going through their related tutorial.
• Redis Sentinel is another deployment configuration focused on high availability. See the Redis Sentinel documentation for more details.
• Read the Redis Quick Start to learn about securing Redis and installing client libraries to use Redis with your applications.
• Refer to the Redis configuration documentation to learn about the Redis configuration file.

Once you've determined how you'd like to configure your Redis deployment, connect to your Linode via SSH to complete your configuration.