Engine Yard Developer Center

Add UNIX Packages to Your Application

You can add additional software packages to your application within Engine Yard Cloud. Packages are added at the account level. After a package is applied to specific environment, it cannot be removed from that environment. (Although, after a package is dissociated from an application, new environments for that application do not have the package.)

To configure additional software packages for your application

  1. In the dashboard, click the name of the environment you want to modify.

  2. Click the Edit Unix Packages link.

  3. Search for your package.

    For example rabbitmq for RabbitMQ.

    Results appear in the Available UNIX Packages list.

  4. Click Add ->.

    The package appears in the Selected UNIX Packages list.

  5. To install the package on an existing environment:

    a. Click Go to dashboard.

    b. Click the environment name.

    c. Click Apply.

  6. To install the package on new environment:

    a. Click Go to dashboard.

    b. Create and boot a new environment for the application.

Tip: To search for exact packages and versions, first run eix-sync on one of your instances, then emerge -s "package_name" to search for specific packages and see what versions are available. Alternatively, eix packagename can be used to show more results.

To remove a software package

  1. In the dashboard, click the name of the environment to remove the software package from.

  2. Click the Edit Unix Packages link.

  3. Click x Remove for the package.

    This removes the package from the UI but does not remove the package from any currently running environments.

More information

For more information about...                                    See...
Create an environment  Create an 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.

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


  • Avatar
    Jason Ivers

    Is this still applicable?  When I click the name of my application from the dashboard, I don't see the icons I used to see for adding gems and Unix packages (gems are in the Gemfile, anyway).

    Is it possible, if this is still the correct documentation that you could either post or send me a screenshot showing where I'm supposed to find the "Unix Packages icon"?  I don't even see Unix or Package(s) anywhere in the source, let alone on the actual page.

  • Avatar
    Keri Meredith

    Hi Jason, The docs need to catch up to the UI, which just changed last week. There is an additional step or two now:

    Go to your app and click the Edit link. The gems and UNIX icons have moved to this page.

    The icons were moved because if you want to add gems to your application, best practice is to use Bundler. This also avoids versioning issues.

    It is also uncommon to have an installation that needs custom UNIX packages without custom Chef. If you're writing custom Chef, then best practice is to install the packages in Chef rather than using the link.

    Hope this clarifies for you. Thanks for the doc reminder. kjm

  • Avatar
    Keri Meredith

    We changed the UI - now you can find the link on the environment page itself. Doc updated accordingly. kjm

  • Avatar
    Marcin Kucharski

    Was it moved again ? :) I do not see it :)

  • Avatar
    Keri Meredith

    Hi Marcin, Sorry about this.

    It's on the Environment page. (I can't see my trial testing account now, so cannot exactly duplicate your situation.)

    Here's where I see it:


  • Avatar
    James Pollard

    Is there a way we can tell what version a unix package with add? For example the unix package for 'media-gfx/imagemagick' just says 'media-gfx/imagemagick'. Would this install imagemagick

Please sign in to leave a comment.

Powered by Zendesk