Posted 9 months ago. Visible to the public.

Changing your deployments ruby version

Default configuration with opscomplete

With the default opscomplete configuration it's not possible to change the ruby version of your deployment on your own.
That is due to the fact that we have to make sure you have the same and correct ruby version on all your servers and that the passenger is using the correct ruby version.

If you want to use another ruby version please contact

The process will then be:

  1. We will prepare the new ruby for your deployment
  2. You deploy your changes
  3. Immediately after that we will restart the webserver with the new ruby configured

Manage the ruby version yourself

Please contact to if you want to manage your ruby version yourself.

These things will get configured:

  • We are installing and configuring rbenv with the ruby-build plugin for your deploy user.
  • Passenger-Ruby will get set to ${HOME}/.rbenv/shims/ruby
  • There will be a cronjob which gets executed any 5 minutes. This cronjobs checks if the ruby version specified in your .ruby-version is currently installed. If there is a problem you will get an email.

If you manage the ruby version yourself you have to take care of the installation and configuration of the ruby versions yourself. You should add a check to your capistrano configuration which installs the needed ruby version. We will provide this in our Capistrano Sample Recipe in the future. Our capistrano-opscomplete gem can manage the ruby version automatically for you.

Important: You also have to make sure the bundler and (if you use it) geordi gem get's installed after installing a new ruby version.

Owner of this card:

Kim Jahn
Last edit:
9 days ago
by Claus-Theodor Riegg
Posted by Kim Jahn to opscomplete
This website uses cookies to improve usability and analyze traffic.
Accept or learn more