Managing your Ruby version

Last modified: June 13th, 2023

Working with a specific static site generator?
Customize CloudCannon's documentation to suit your SSG.

Great! We'll show you documentation relevant to .
You can change this any time using the dropdown in the navigation bar.

CloudCannon supports Ruby versions using rbenv. Jekyll sites without the version specified default to version 2.7.3.

Versions installed are:

  • 2.6.2
  • 2.6.6
  • 2.6.7
  • 2.7.1
  • 2.7.3 (default)
  • 3.0.0
  • 3.0.1
  • 3.1.3
  • 3.2.0

If you require a Ruby version not listed above, please contact support. We will do our best to accommodate your needs.

Setting your version#

To set your version add a .ruby-version file in the root folder. This file should contain one of versions specified above.

Here’s an example .ruby-version:


Install rbenv on your local environment to ensure the same version is used. It is considered best practice to set your ruby version per project. This ensures that local builds and CloudCannon builds use the same version of Ruby.

Related links

Open in a new tab