Connecting to Redis
Every Redis instance exposes two endpoints. Use the one that matches where you’re connecting from.
Internal vs external
Section titled “Internal vs external”| URL | Format | When to use it |
|---|---|---|
| Internal | redis:// | From other Runsite services in the same project. Stays on the private network: lowest latency, no public exposure. |
| External | rediss:// (TLS) | From your laptop, third-party tools, or anything running outside Runsite. Encrypted in transit. |
Both URLs are standard Redis connection strings. You’ll find them on the instance’s Overview tab. Copy them directly rather than constructing them by hand. The username is empty (Redis only uses the password).
A real internal URL looks like:
redis://:Xy9Pq~rN2fGHaUpQbZ~mLk7s@red-vakdj328fj02kdnv-a:6379A real external URL looks like:
rediss://:Xy9Pq~rN2fGHaUpQbZ~mLk7s@red-vakdj328fj02kdnv-a.eu-central-redis.runsite.appNotice:
- The internal host (
red-...-a) is short and only resolves inside Runsite. Default port:6379is explicit. - The external host adds the region and base domain (
eu-central-redis.runsite.app). Port is implicit; TLS clients use the standard Redis port automatically. - The external URL uses
rediss://(with twos), which is the TLS scheme. Don’t drop the secondsor your client will try plain TCP.
From a Runsite Web Service
Section titled “From a Runsite Web Service”Inside another Runsite service in the same project, use the internal URL. Add it as an environment variable in the service’s Environment tab:
REDIS_URL=redis://:Xy9Pq~rN2fGHaUpQbZ~mLk7s@red-vakdj328fj02kdnv-a:6379Most Redis clients (ioredis, redis-py, go-redis, node-redis) accept this URL directly.
From your laptop
Section titled “From your laptop”Use the external URL with redis-cli:
redis-cli -u "rediss://:Xy9Pq~rN2fGHaUpQbZ~mLk7s@red-vakdj328fj02kdnv-a.eu-central-redis.runsite.app"Or paste it into your client (RedisInsight, Medis); they all accept the standard URL.
Credentials
Section titled “Credentials”The dashboard masks the password in both URLs. Click the eye icon on the Overview tab to reveal it.
There is no password reset. If the password leaks, create a new instance and switch your app to it.
Connection failing? See Fix Redis connection and memory errors.