Setting Your Ruby Version

Ruby version 3.3.0 is the default for Render services created on or after 2024-03-18.

Set a different Ruby version in any of the following ways (in descending order of precedence):

1. Include a Gemfile.lock or a gems.locked file in the root of your repo that specifies the version to use under RUBY VERSION:

   # Gemfile.lock
   RUBY VERSION
     ruby 3.3.0

   You can add this entry to an existing Gemfile.lock file or update its value by running:

   bundle update --ruby

2. Add a file named .ruby-version to the root of your repo. This file contains a single line with the version to use:

   3.3.0

3. Add a file named .tools-version to the root of your repo. This file can specify versions for multiple languages. To set the Ruby version, add a line like the following:

   ruby 3.3.0

4. Set the ruby directive in your Gemfile.

To avoid version mismatches across environments, you can set your Ruby version in the .ruby-version file, then read the value from that file in your Gemfile:

# Gemfile
ruby file: ".ruby-version"

History of default Ruby versions

If you don’t set a Ruby version for your service, Render’s default version depends on when you originally created the service: