Setting Your Ruby Version

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:

   ruby

   # 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:

   shell

   $ 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:

   text

   3.3.0

3. Add a file named .tool-versions 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:

   text

   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: