Upcoming changes to REDIS_URL for Heroku Data for Redis Mini add-ons

Change effective on 22 July 2024

On September 30, 2024, the REDIS_URL config var will become the secure TLS connection URL for all mini Heroku Data for Redis add-on plans. We’ll begin rolling REDIS_URL config vars to the TLS connection for mini add-on plans on that date.

We’re deprecating REDIS_TLS_URL on December 2, 2024. If you use REDIS_TLS_URL, you can switch to REDIS_URL after September 30, 2024.

Currently for mini plans, REDIS_URL is the insecure connection while REDIS_TLS_URL is the secure connection. We’re deprecating REDIS_TLS_URL in favor of a unified REDIS_URL for all add-on plans.

Customers using REDIS_URL on mini plans who must keep their insecure connections to prepare their app for supporting TLS can transfer their configuration to a temporary, insecure config var REDIS_TEMPORARY_URL. REDIS_TEMPORARY_URL and REDIS_TLS_URL will be available until December 2, 2024. By that date, all Redis connections require TLS with REDIS_URL.

Before December 2, ensure that you update all libraries that connect to Redis, such as redis. You must also deactivate SSL verification for the mini instance connections. Here’s a Ruby on Rails example of connecting to a TLS connection in a staging 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

See this Help article and Connecting to Heroku Data for Redis for more information on config var changes.