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