🚀 Redis Stack + Sentinel Installation Guide (Ubuntu)

This guide walks you through installing and configuring Redis Stack and Sentinel on Ubuntu, including systemd service setup and ACL handling.

📦 1. Add Redis Package Source

sudo apt-get install lsb-release curl gpg
curl -fsSL <https://packages.redis.io/gpg> | sudo gpg --dearmor -o /usr/share/keyrings/redis-archive-keyring.gpg
sudo chmod 644 /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
sudo apt-get update

🔧 Optional Fix: If your system codename isn’t supported (e.g. noble), manually set it:

sudo sed -i 's/noble/jammy/' /etc/apt/sources.list.d/redis.list
sudo apt-get update

🔧 Optional Fix: If your system codename isn’t supported (e.g. noble), manually set it:

sudo sed -i 's/noble/jammy/' /etc/apt/sources.list.d/redis.list
sudo apt-get update

🔧 2. Install Redis Stack and Sentinel

sudo apt-get install redis-stack-server redis-sentinel

To reinstall or reset:

sudo apt-get remove redis-stack-server redis-sentinel
sudo apt-get install redis-stack-server redis-sentinel

⚙️ 3. Configure Systemd Service

Rename the service file if needed:

sudo mv /etc/systemd/system/redis-stack.service /etc/systemd/system/redis-stack-server.service

Edit or create the unit file:

sudo nano /etc/systemd/system/redis-stack-server.service

Make sure to reference the correct config:

[Service]
ExecStart=/usr/bin/redis-server /etc/redis-stack.conf

The config file should contain

bind 0.0.0.0

port 6379
supervised systemd
daemonize no

masteruser <user, put this into the acl>
masterauth <password>

aclfile "/etc/redis-stack/redis.acl"

appendonly yes
appendfilename "appendonly.aof"

# Generated by CONFIG REWRITE
dir "/var/lib/redis-stack"
latency-tracking-info-percentiles 50 99 99.9

protected-mode no

loadmodule /opt/redis-stack/lib/rediscompat.so
loadmodule /opt/redis-stack/lib/redisearch.so
loadmodule /opt/redis-stack/lib/redistimeseries.so
loadmodule /opt/redis-stack/lib/rejson.so
loadmodule /opt/redis-stack/lib/redisbloom.so
loadmodule /opt/redis-stack/lib/redisgears.so v8-plugin-path /opt/redis-stack/lib/libredisgears_v8_plugin.so

replicaof <host_of_master> 6379

Then reload and restart:

sudo systemctl daemon-reload
sudo systemctl start redis-stack-server
sudo systemctl status redis-stack-server

To enable at boot:

sudo systemctl enable redis-stack-server

🔐 4. Set Up Redis Config + ACL

Example config paths:

/etc/redis-stack.conf
/etc/redis-stack/redis.acl

Ensure proper permissions:

sudo chown redis:redis /etc/redis-stack.conf
sudo chmod 644 /etc/redis-stack.conf

sudo touch /etc/redis-stack/redis.acl
sudo chown redis:redis /etc/redis-stack/redis.acl
sudo chmod 640 /etc/redis-stack/redis.acl

Make sure data directories are accessible:

sudo chown -R redis:redis /var/lib/redis-stack
sudo chown -R redis:redis /var/lib/redis-stack/appendonlydir

🛠 5. Debugging Tools

sudo journalctl -xeu redis-stack-server.service
sudo systemctl status redis-stack-server.service

You can also run it directly to check logs:

sudo redis-server /etc/redis-stack.conf

✅ Final Check

Ensure everything is running:

sudo systemctl status redis-stack-server
sudo systemctl status redis-sentinel

📝 Notes

  • Redis Stack binaries are usually located at /opt/redis-stack/bin/redis-server

  • Use redis-server, the stack server is compiled differently

  • Sentinel setups require its own .conf and ACL (optional)