If you already have a Redis or Redis-compatible server, such as Redis Cloud or your own, you can point your app at it instead of starting dply Valkey. dply stores the address encrypted, sets the same environment variables it sets for dply Valkey, and leaves the server itself alone. dply does not run, monitor, or bill an external Redis.
Connect an address
- In your app, open Overview.
- Choose Add resource, then dply Valkey.
- Choose Attach existing.
- Enter a Name, such as
Cache. - Paste the Address, for example
rediss://default:secret@cache.example.com:6379. - Choose Attach, then deploy the app.
The address must start with redis:// or rediss://. It is encrypted and is not shown again in the builder. An app can have one Redis connection. To switch from dply Valkey to an external Redis, delete the Valkey connection first.
Tip
Use rediss:// (TLS) whenever your provider offers it. The app connects straight to the address over the internet, so the server must accept connections from outside your provider's network.
What the app receives
On each deploy, dply sets these from the address:
| Variable | Value |
|---|---|
REDIS_URL |
The address you pasted |
REDIS_USERNAME |
The user in the address, or default |
REDIS_PASSWORD |
The password in the address |
REDIS_HOST |
The host in the address |
REDIS_PORT |
The port in the address |
For a Laravel app it also sets CACHE_STORE=redis, REDIS_CLIENT=phpredis, and REDIS_PERSISTENT=true. Any of these you save in Environment variables wins.
Laravel
# Not set by dply. Add it in Environment to keep sessions in Redis:
SESSION_DRIVER=redis
For queues, add queue workers with their Connection set to redis. While they run, dply sets QUEUE_CONNECTION=redis for you.
Node
import { createClient } from 'redis';
const redis = await createClient({ url: process.env.REDIS_URL }).connect();
Hosted Redis
Copy the provider's connection string and paste it as the address. Most hosted Redis requires TLS: keep the rediss:// scheme when the string has it.
Test, replace, or remove
Choose Open on the Redis card to see the address (password masked) and the values set on the app.
- Test connection connects from dply, signs in, and sends
PING. The host must be reachable from the internet. - Replace address saves a new
redis://orrediss://address. The app uses it on the next deploy. - Remove from this app takes
REDIS_URLand the other Redis values off the app on the next deploy. The Redis server and its data are not touched.
The Sleep button on the card also takes the address off the app on the next deploy and keeps it saved; Wake puts it back.