Connection Troubleshooting
Learn how to add a Redis connection and resolve common setup errors.
Use this guide if you are adding a new Redis connection and the test or create flow fails.
How to Add a Connection
- Open Connections in the app.
- Click Add Connection.
- Fill in:
- Connection Name
- Connection URL
- Environment
- Allow self-signed TLS certificates (only when your provider requires it)
- Click Test to verify connectivity before saving.
- Click Create Connection.
Common Connection Issues
TLS Encryption
Ensure your protocol is set to rediss:// instead of redis:// (note the extra s).
Self-Signed TLS Certificates
Some managed Redis providers, including Heroku Key-Value Store, terminate TLS with self-signed certificates. Durabull validates TLS certificates by default, so these connections fail unless you opt in.
When adding or editing a connection:
- Use a
rediss://URL. - Enable Allow self-signed TLS certificates.
- Re-run Test before saving.
For env-driven connections, set:
DURABULL_REDIS_URL_MAIN=rediss://...
DURABULL_REDIS_URL_MAIN_ALLOW_SELF_SIGNED_CERTS=true
Only enable this when your provider requires it. It disables certificate authority validation for that connection.
IP Allowlisting
If your setup restricts incoming traffic, you will need to allowlist these Durabull IP ranges:
74.220.48.0/2474.220.56.0/24
Quick Verification Checklist
- Confirm host, port, username, and password are correct.
- Confirm TLS is enabled when your provider requires it.
- Confirm network allowlists and firewall rules include Durabull source ranges.
- Re-run Test in the modal after each change.