Redis Provider¶

After you've added the Redis Provider package to your project, setting the provider up in code is easy.

Add to Droplet¶

First, register the RedisProvider.Provider with your Droplet.

import Vapor
import RedisProvider

let config = try Config()
try config.addProvider(RedisProvider.Provider.self)

let drop = try Droplet(config)

...

Once the provider is added to your Droplet, you can configure Vapor to use Redis for caching.

Config/droplet.json

{
    "cache": "redis"
}

Seealso

Learn more about configuration files in the Settings guide.

If you run your application now, you will likely see an error that the Redis configuration file is missing. Let's add that now.

Here is an example of a simple Redis configuration file.

Config/redis.json

{
    "hostname": "127.0.0.1",
    "port": 6379,
    "password": "secret",
    "database": 2
}

Both password and database are optional.

Note

It's a good idea to store the Redis configuration file in the Config/secrets folder since it may contain sensitive information.

You can also pass the Redis credentials as a URL.

Config/redis.json

{
    "url": "redis://:secret@127.0.0.1:6379/2"
}

Both password and database are optional.

You are now ready to start using Cache with your Redis database.