Skip to content

Ruby Versions

On this page:


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

Versions installed are:

  • 2.3.8 (End of Life)
  • 2.4.6
  • 2.4.10
  • 2.5.5
  • 2.5.8
  • 2.6.2
  • 2.6.6
  • 2.7.1
  • 3.0.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.


The legacy site building system won’t use your Ruby version. Ensure you have the Enable Ruby versions and non-legacy building option enabled in Site Settings / Details. The legacy system is for sites created years ago and is being gradually phased out.

On this page:


Don’t miss the latest
CloudCannon news freshly delivered to your inbox