# Set up Redis

With Laravel, you can use Redis to handle session storage, cache storage, and queues.

## 1. Add the Redis service

1. [Add the service](https://docs.upsun.com/add-services.md#add-a-service) to your app configuration using the `services` top-level key:

   ```yaml  {location=".upsun/config.yaml"}
   services:
     [...]
     redis:
       type: redis:7.0
   ```

2. To connect the service to your app, add the following relationship:

   ```yaml  {location=".upsun/config.yaml"}
   applications:
     myapp:
       [...]
       relationships:
         redis:

   services:
     [...]
     redis:
       type: redis:7.0
   ```

## 2. Configure your Redis service

The [Redis](https://docs.upsun.com/add-services/redis.md) configuration is exposed via the following environment variables
(where `REDIS` is the upper-cased version of the key defined in the relationship):

- `REDIS_URL`: The Redis URL
- `REDIS_HOST`: The Redis host
- `REDIS_PORT`: The Redis port
- `REDIS_SCHEME`: The Redis scheme

If the relationship is named `redis`, Laravel automatically detects these variables and configure its own Redis driver the right way.
If not, you can map the variables in the `.environment` file.

You can specify the Redis client in your `.environment` file:

```bash   {location=".environment"}
export REDIS_CLIENT="phpredis"
```

**Note**: 

If using ``phpredis``, make sure you add ``redis`` in the list of PHP ``runtime`` extensions in your ``.upsun/config.yaml``:

    .upsun/config.yaml

```yaml {}
applications:
  myapp:
    [...]
    runtime:
      extensions:
        - redis
```

## 3. Store the Laravel cache in Redis

To enable cache storage in Redis, add the following environment variable to your `.environment` file:

```bash   {location=".environment"}
export CACHE_STORE="redis"
```

## 4. Store Laravel sessions in Redis

Laravel relies on the `SESSION_DRIVER` variable to store sessions. Therefore, add the following environment variable to your `.environment` file:

```bash   {location=".environment"}
export SESSION_DRIVER="redis"
```

## 5. Use Redis for Laravel queues

For a basic queueing system, configure the `QUEUE_CONNECTION` in your `.environment` file as follows:

```bash   {location=".environment"}
export QUEUE_CONNECTION="redis"
```

For more information, see the [Laravel Queues documentation](https://laravel.com/docs/master/queues)
and Upsun's [Horizon configuration page](https://docs.upsun.com/get-started/stacks/laravel/laravel-horizon.md).