🚀 GoFr Summer of Code 2025 is Live. Register Now !
Join Now

Quick Start Guide

Connecting to Redis

GoFr simplifies the process of connecting to Redis.

Setup:

Ensure we have Redis installed on our system.

Optionally, we can use Docker to set up a development environment with password authentication as described below.

docker run --name gofr-redis -p 2002:6379 -d \
	-e REDIS_PASSWORD=password \
	redis:7.0.5 --requirepass password

We can set a sample key greeting using the following command:

docker exec -it gofr-redis bash -c 'redis-cli SET greeting "Hello from Redis."'

Configuration & Usage:

GoFr applications rely on environment variables to configure and connect to a Redis server.
These variables are stored in a .env file located within the configs directory at your project root.

Required Environment Variables:

KeyDescription
REDIS_HOSTHostname or IP address of your Redis server
REDIS_PORTPort number your Redis server listens on (default: 6379)
REDIS_USERRedis username; multiple users with ACLs can be configured. See official docs
REDIS_PASSWORDRedis password (required only if authentication is enabled)
REDIS_DBRedis database number (default: 0)

TLS Support (Optional):

KeyDescription
REDIS_TLS_ENABLEDSet to "true" to enable TLS
REDIS_TLS_CA_CERT_PATHFile path to the CA certificate used to verify the Redis server
REDIS_TLS_CERT_PATHFile path to the client certificate (for mTLS)
REDIS_TLS_KEY_PATHFile path to the client private key (for mTLS)

✅ Example .env File

REDIS_HOST=redis.example.com
REDIS_PORT=6379
REDIS_USER=appuser
REDIS_PASSWORD=securepassword
REDIS_DB=0

# TLS settings (optional)
REDIS_TLS_ENABLED=true
REDIS_TLS_CA_CERT_PATH=./configs/certs/ca.pem
REDIS_TLS_CERT_PATH=./configs/certs/client.crt
REDIS_TLS_KEY_PATH=./configs/certs/client.key

The following code snippet demonstrates how to retrieve data from a Redis key named "greeting":

package main

import (
	"errors"

	"github.com/redis/go-redis/v9"

	"gofr.dev/pkg/gofr"
)

func main() {
	// Initialize GoFr object
	app := gofr.New()

	app.GET("/redis", func(ctx *gofr.Context) (any, error) {
		// Get the value using the Redis instance

		val, err := ctx.Redis.Get(ctx.Context, "greeting").Result()
		if err != nil && !errors.Is(err, redis.Nil) {
			// If the key is not found, we are not considering this an error and returning ""
			return nil, err
		}

		return val, nil
	})

	// Run the application

	app.Run()
}