Skip to content

Installing Redis

ColibriPlus uses Redis for caching, queues, and sessions and for other performance optimization purposes.

If you prefer to use another cache system like Memcached, you can skip this guide and refer to the official documentation of your cache system.

✅ Recommended version: Redis 6.0+


1. Install Redis

Ubuntu / Debian

bash
sudo apt update
sudo apt install redis-server
sudo systemctl enable redis
sudo systemctl start redis
sudo systemctl status redis

CentOS / RHEL

bash
sudo yum install redis
sudo systemctl enable redis
sudo systemctl start redis
sudo systemctl status redis

macOS

bash
brew install redis
brew services start redis

Test Redis

If everything above is done correctly, you can test Redis by running the following command. You should see PONG in the output.

bash
redis-cli ping

2. Configure ColibriPlus

Open the .env file and update the following variables:

env
CACHE_DRIVER=redis
QUEUE_CONNECTION=redis


REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379

PHP Redis Extension

ColibriPlus uses the PHP Redis extension to interact with Redis.

Ubuntu / Debian

bash
sudo apt install php-redis
sudo systemctl restart php8.2-fpm

CentOS / RHEL

bash
sudo yum install php-redis
sudo systemctl restart php8.2-fpm

macOS

bash
brew install php-redis
brew services restart php@8.2

If everything above is done correctly, you can test Redis by running and you can continue to the next step.

Developed by Mansur Terla. www.terla.me