Skip to content

Connecting to Redis

Every Redis instance exposes two endpoints. Use the one that matches where you’re connecting from.

URLFormatWhen to use it
Internalredis://From other Runsite services in the same project. Stays on the private network: lowest latency, no public exposure.
Externalrediss:// (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:6379

A real external URL looks like:

rediss://:Xy9Pq~rN2fGHaUpQbZ~mLk7s@red-vakdj328fj02kdnv-a.eu-central-redis.runsite.app

Notice:

  • The internal host (red-...-a) is short and only resolves inside Runsite. Default port :6379 is 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 two s), which is the TLS scheme. Don’t drop the second s or your client will try plain TCP.

Inside another Runsite service in the same project, use the internal URL. Add it as an environment variable in the service’s Environment tab:

Terminal window
REDIS_URL=redis://:Xy9Pq~rN2fGHaUpQbZ~mLk7s@red-vakdj328fj02kdnv-a:6379

Most Redis clients (ioredis, redis-py, go-redis, node-redis) accept this URL directly.

Use the external URL with redis-cli:

Terminal window
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.

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.

IP geolocation by DB-IP