Upgrade an Environment

From time to time, Engine Yard releases a new stack version. When a new stack is released, you have the option to upgrade your environment and take advantage of the latest features and fixes. Some reasons Engine Yard releases a new stack are:

  • Upgrading a stack component to a newer version
  • Addressing vulnerabilities
  • Bug fixes

When Engine Yard releases a new stack, an ! Upgrade… button appears on the environment.

upgrades available

Before you upgrade, you can review the changes that will be applied to your current environment.

Tip: If you are interested in learning about upcoming releases, you should subscribe to this forum.


This is the process for upgrading a production environment:

Cloned environments vs. new environments

When you clone an environment, the cloned stack is the same version as the original stack. However, if you create a new environment, it is always the latest stack version.

About adding instances to an existing environment

When you add a new instance to an existing environment, the added instance is the same stack version as the other instances in that environment. You do not have to upgrade before adding an instance.

Test an upgrade

Best practice is to test in a non-production environment before upgrading a production environment. Don’t upgrade your production environment until you have validated the upgrade in a test environment.

To test an upgrade

  1. Clone the environment. (See Clone an environment.)
  2. Upgrade the cloned environment, following the procedure below.
  3. Test the application on the cloned environment.
  4. Upgrade the production environment, following the procedure below.
  5. Decommission the cloned environment. (See Delete an environment.)

Upgrade an environment

When a new stack is available, a “Please Upgrade” message appears on your Dashboard and the ! Upgrade button appears on the environment pages.

Important! If your stack is very out-of-date, you see this message: “Upgrading will enable Stack Change Management.” Remember, when updating a very out-of-date stack for a production environment, always test in a cloned environment first.

To upgrade an environment

  1. In your Dashboard, click the environment name.
  2. Click ! Upgrade…
    The Upgrades Available page appears.
  3. Review the Changes list.
  4. Click Upgrade Environment.

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


Article is closed for comments.