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

```ruby