Use Ruby 2 on Engine Yard


This document describes how to use the Ruby 2 feature on Engine Yard.

Get started with Ruby 2 on Engine Yard


  • This article assumes you already have an Engine Yard account. If not, see Sign up for an Engine Yard Account.
  • To use Ruby 2 in your environment, you must use the Engine Yard Gentoo 12.11 stack option (stable-v4).
  • Your environment must include other component versions as described in the Engine Yard Gentoo 12.11 Tech Stack.
  • You must use 64-bit instances (32-bit instances are not supported on this distribution).
  • In order to deploy your app, you must use the engineyard gem (2.1.0.rc1 or newer) with this feature.

    The engineyard gem can be installed by running:

    gem install engineyard

    For more information, see the Engine Yard gem repo on GitHub.

    Note: If you aren't sure which version of the engineyard gem you have installed, you can check with:

    $ ey --version
    engineyard version 2.1.0.rc1

Use Ruby 2 with Engine Yard

Important: We recommend testing in a staging environment before applying changes in a production environment.

To deploy a new app using Ruby 2

  1. Ensure that your app meets all the prerequisites above.

  2. Create your application in the usual way.

    Note: Your stack selections should be on the Engine Yard Gentoo 12.11 Tech Stack.

  3. Create a new environment in the usual way.

    Note: Your stack selections should be on the Engine Yard Gentoo 12.11 Tech Stack.

  4. Select the new Gentoo 12.11 Stack: stable-v4.

    This displays the configuration choices for your Engine Yard Gentoo 12.11 environment.

  5. Select the Ruby 2 Runtime that you need.

  6. On the Configuration page, select the environment setup you need.

  7. Click Boot this Configuration.

    Your Engine Yard Gentoo 12.11 environment starts up with Ruby 2 runtime.

More Information

These other resources might help you:

For more information about ...See ...
Ruby 2 releases Ruby release news
Engine Yard gem Engine Yard gem change log
Engine Yard Gem 2.0 blog Deploying with engineyard gem version 2.0
Engine Yard Gem 2.3 blog Deploying with engineyard gem version 2.3
Migrate Ruby Migrate to the Latest Ruby Version

If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request


  • Avatar
    Vincent Franco

    When will we be able to upgrade existing stacks?

  • Avatar
    Keri Meredith

    Hi Vincent, please confirm: are you talking about upgrading from the Engine Yard Gentoo (stable-v2) to the Engine Yard Gentoo 12.11 (stable-v4) stack? Or are you referring to a different migration? thanks, kjm

  • Avatar
    Keri Meredith

    The original Ruby doc had a prereq about upgrading due to most customers being on Engine Yard Gentoo 2009 (stable-v2) at that time. FYI: The docs describing migrating from Engine Yard Gentoo 2009 to Engine Yard Gentoo 12.11 (stable-v4) are:

    Simple migration


    Custom migration

    If you are already on Engine Yard Gentoo 12.11 (stable-v4), upgrading Ruby should be fine.

    As always, if you have any questions or concerns, our awesome Support team is happy to help. kjm

  • Avatar
    Keri Meredith