Install Redis on Ubuntu

You need a fast, in-memory data store for caching, real-time analytics, or session management, but you're staring at a fresh Ubuntu server wondering where to start. Without a clear installation path, you risk broken dependencies, misconfigured services, or a security nightmare. This lesson walks you through the official, production-ready way to install Redis on Ubuntu — so you can move from zero to redis-cli ping → PONG in under 10 minutes.

The problem this lesson solves

Redis is the go‑to cache and message broker for modern applications — but getting it onto Ubuntu cleanly isn't always obvious. Package managers may deliver an ancient version, manual compilation can lead to scattered binaries, and skipping basic security leaves your instance open to remote attacks. This lesson addresses all three: you'll learn how to install a recent, stable Redis release via apt, verify it works, and configure it for safe use. Without this step, every subsequent lesson on caching, TTLs, and pub/sub is built on a shaky foundation.

Core concept / mental model

Think of Redis as a lightning‑fast dictionary living in RAM. Installing Redis on Ubuntu is like placing that dictionary on a shelf where both your application and command line can reach it. The installation process:

1. Adds the official Redis repository — ensures you get the latest stable version, not the OS's outdated one.
2. Installs the redis-server package — this includes the server binary, the CLI client (redis-cli), and systemd service files.
3. Starts the service — brings the in‑memory store to life and makes it persist across reboots.
4. Verifies connectivity — you ping the server to confirm it's alive.

💡 Mental shortcut: Redis on Ubuntu === one sudo apt command away, plus two minor configuration tweaks. The rest is just verifying it works.

How it works step by step

Step 1: Update package list and install dependencies

Before adding any external repo, refresh your local package index. Python‑like idiom: apt update is like calling pip install -r requirements.txt — it prepares your environment.

sudo apt update

Then install lsb-release and curl — these let you add the official Redis GPG key and repository.

sudo apt install -y lsb-release curl

Step 2: Add the official Redis APT repository

Redis maintains its own repo for Ubuntu. You'll download their GPG key and add it to your trusted keys, then add the repository to your sources list.

curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

Step 3: Install Redis

Now that the repo is configured, update your package list and install redis-server.

sudo apt update
sudo apt install -y redis-server

Step 4: Start and enable the service

Ubuntu uses systemd. Enable Redis to start automatically on boot, then start it immediately.

sudo systemctl enable redis-server
sudo systemctl start redis-server

Step 5: Verify installation

Use redis-cli to ping the server. A PONG response confirms everything is running.

redis-cli ping
# Output: PONG

Hands-on walkthrough

Let's put this all together into one clean script you can run on a fresh Ubuntu 22.04 or 24.04 LTS machine.

Complete one‑shot example

Create a file install-redis.sh with:

#!/usr/bin/env bash
set -euo pipefail

# Update packages
sudo apt update
sudo apt install -y lsb-release curl

# Add Redis repo
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/redis-archive-keyring.gpg] https://packages.redis.io/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/redis.list

# Install Redis
sudo apt update
sudo apt install -y redis-server

# Enable and start
sudo systemctl enable redis-server
sudo systemctl start redis-server

# Verify
redis-cli ping

Run it:

chmod +x install-redis.sh
./install-redis.sh

Expected output (after script completes):

PONG

Python example to confirm connectivity

If you want to test from Python (after installing redis-py):

import redis

# Connect to local Redis (default host/port)
r = redis.Redis(host='localhost', port=6379, decode_responses=True)

# Ping the server
print(r.ping())  # Output: True

# Set and get a key
r.set('lesson', 'install-redis-on-ubuntu')
print(r.get('lesson'))  # Output: install-redis-on-ubuntu

Compare options / when to choose what

💡 Recommendation: For this track, use the official APT repo. It balances freshness with stability and integrates cleanly with systemd.

Troubleshooting & edge cases

Problem: "Failed to start redis-server.service: Unit not found"

Cause: The apt install didn't complete successfully, or you're on an unsupported Ubuntu version (e.g., older than 18.04).

Fix:

# Verify Redis is installed
which redis-server

# If missing, re-run install
sudo apt install --reinstall redis-server

Problem: redis-cli ping hangs or times out

Cause: Redis is bound to 127.0.0.1 only by default, but your CLI might be trying IPv6. Or the service didn't start.

Fix:

# Check service status
sudo systemctl status redis-server

# Test with explicit host
redis-cli -h 127.0.0.1 ping

Problem: "W: GPG error: ... NO_PUBKEY"

Cause: The GPG key wasn't imported correctly.

Fix:

# Re-import the key
curl -fsSL https://packages.redis.io/gpg | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
sudo apt update

Edge case: Already installed a different version from Ubuntu's repo

If you previously ran sudo apt install redis-server without the official repo, you'll have an older version. Remove it first:

sudo apt purge redis-server
sudo apt autoremove
# Then follow the official repo steps above

What you learned & what's next

You now know how to install Redis on Ubuntu using the official repository — adding the GPG key, installing redis-server, enabling the systemd service, and verifying with redis-cli ping. You also learned the difference between official and default repo versions and how to troubleshoot common installation hiccups.

This is the foundation for the entire Redis track. In the next lesson, you'll configure Redis basics: setting a password, binding to a specific interface, and tuning the maxmemory policy to prevent your server from swapping. These next steps are essential before you start building caches or pub/sub pipelines.

🧠 Key insight: A correctly installed Redis is the springboard for everything else — from TTL management to Streams. Take 5 minutes to run the one-liner script above; it'll save you hours of debugging later.