🧠Redis Configuration

If you choose to use the Redis driver for horizontal scalability, rate-limiting data storage, or queue support, you will need to configure additional environment variables to instruct soketi on how to connect to Redis.

If you are not using Redis for rate limiting or queues, these environment variables are not required.

Environment Variables

Name	Default	Possible values	Description
SOKETI_DB_REDIS_HOST	127.0.0.1	Any string	The Redis host.
SOKETI_DB_REDIS_PORT	6379	Any integer	The Redis port.
SOKETI_DB_REDIS_DB	0	Any integer	The Redis database.
SOKETI_DB_REDIS_USERNAME	null	Any string	The Redis username.
SOKETI_DB_REDIS_PASSWORD	null	Any string	The Redis password.
SOKETI_DB_REDIS_KEY_PREFIX	null	Any string	The Redis key prefix that should be utilized.

Redis Sentinel

The following additional options are available when connecting to Redis through one or more Sentinels.

Please be aware that utilizing the Sentinel options will override some of the other options like SOKETI_DB_REDIS_HOST and SOKETI_DB_REDIS_PORT, but not SOKETI_DB_REDIS_DB or SOKETI_DB_REDIS_PASSWORD. More details can be found in the ioredis documentation for Redis Sentinel.

Name	Default	Possible values	Description
SOKETI_DB_REDIS_SENTINELS	null	Any string	A JSON-encoded array of objects with host and port of Sentinels to connect to.
SOKETI_DB_REDIS_SENTINEL_PASSWORD	null	Any string	The (optional) password that is used to authenticate with the Sentinels.
SOKETI_DB_REDIS_INSTANCE_NAME	mymaster	Any string	The name of the Redis instance to which a connection should be established through the configured Sentinels.

Redis Cluster

The following additional options are available when connecting to Redis Cluster configurations.

Please be aware that utilizing the Cluster options will override some of the other options like SOKETI_DB_REDIS_HOST and SOKETI_DB_REDIS_PORT, but not SOKETI_DB_REDIS_DB or SOKETI_DB_REDIS_PASSWORD. More details can be found in the ioredis documentation for Redis Cluster.

Name	Default	Possible values	Description
SOKETI_DB_REDIS_CLUSTER_NODES	[]	Any string	A JSON-encoded array of objects with host and port of Nodes to connect to.