REDIS_URL is the TLS connection for Heroku Data for Redis Mini add-ons

Change effective on 30 September 2024

The REDIS_URL config var is now the secure TLS connection URL for all mini Heroku Data for Redis add-ons. We’ll begin rolling REDIS_URL config var values to the TLS connection for existing mini add-on plans.

As previously announced, REDIS_TLS_URL and REDIS_TEMPORARY_URL deprecates on December 2, 2024. By that date, all Redis connections require TLS with REDIS_URL. If you’re using REDIS_TLS_URL, switch now to REDIS_URL for TLS connections. If you’re using REDIS_URL and must keep your insecure connections, use the REDIS_TEMPORARY_URL config var to prepare your app for supporting TLS.

See this FAQ and Connecting to Heroku Data for Redis for more information on config var changes and examples for the most popular Redis clients in all of Heroku’s supported languages.

Preparing for the change

Ensure all libraries that connect to Redis, such as redis, are updated. You must also deactivate SSL verification for the mini instance connections. For details, see Connecting to Heroku Key-Value Store.

Before December 2nd, we suggest you ensure that your application can connect to a Redis TLS connection in a staging application. Here is an example of that for a Ruby on Rails application:

# config/application.rb
if redis_url = ENV["REDIS_TLS_URL"]
  ENV["REDIS_URL"] = redis_url
  warn "Using secure redis URL"
else
  warn "No REDIS_TLS_URL environment variable set"
end

If your application can connect and run to the secure URL on the REDIS_TLS_URL environment variable, it will be prepared for this change.