An environment name should uniquely identify the environment in your dashboard. Use underscores to separate words instead of spaces. Examples: myapp_production, myapp_staging.
Important: The environment name cannot be changed later.
Select an environment type from the list.
This populates RAILS_ENV and RACK_ENV. For example, this would be the equivalent to entering the environment variable RAILS_ENV=production in the command line.
This populates NODE_ENV and FRAMEWORK_ENV.
This populates PHP_ENV.
Application Server Stack
Select an application server from the list.
The default is Passenger 3; it is used for production and multi-application environments. If you need to run more than one application on an environment, choose Passenger.
If you will be running only one application on an environment (this is more common practice), then choose Unicorn. Engine Yard has found Unicorn to be reliable, easier to monitor, and to have less downtime during deployment. You need the Unicorn gem for this selection.
Trinidad provides an option if you have a Rack app using Apache Tomcat. You need the Trinidad gem for this selection.
Select the interpreter and version that your application has been developed with. Options include: Ruby, JRuby, REE, Rubinius.
Select the appropriate RubyGems version for this environment. For example, an older version of Rails would need a different RubyGems version than the default.
Select the database you need for this environment. The default is PostgreSQL, or you can also use MySQL.
The No Database option is available if you choose to use an alternative data store like Riak or MongoDB. For example, you can use a utility instance and create your own data store. Or you can use this option along with a database offering from the Engine Yard add-on program.
The default for all new and existing environments is to lock the minor database version (that is, the Prevent minor database version changes option is selected). However, the preferred policy is to allow minor database version changes whenever possible.
If the option is selected (checked), then stack upgrades on that environment will not include processing any minor database version upgrades included in the general stack upgrades (that is, your database’s version will be locked at whatever it currently is).
If the option is not selected, then minor database version upgrades will be processed whenever they are included in the weekly stack release.
Note: If you need a new environment to run an earlier minor database version (for example, to match another existing environment), contact Engine Yard Support.
The default is to allow any collaborator to terminate an instance in the environment. If you are the account owner, you can require users to re-enter their password before allowing an instance to be terminated.
Select the appropriate application takeover option for this environment:
Boot from snapshot - The default method boots a replacement app slave from a new app master snapshot.
You might use this if you have data on your volume or if you have a large application.
Note: Engine Yard does not recommend keeping data on your app master.
Boot from new volume - This preferred method creates a new volume and builds a replacement app slave from that new volume.
This is a faster method than the default. It is preferred because you are starting fresh with a new volume.
Note: This option assumes you do not need to preserve any data on your app master.
Don't boot app slave - Takeovers still happen, but the app slave won't be replaced automatically.
Note: This is an option if your environment requires manual intervention when creating a new app slave.
Disable - No app master takeovers occur. You will need to manually initiate takeovers.
Note: This is an option for larger environments and environments with instances behind ELB for example. (See Use ELB doc for more information.)
(Optional) Type your domain name for this application in this environment. If you are only adding one application to this environment, you can leave the Domain Name blank (not set). You can also leave the name blank to make the environment answer requests for any domain.
If this is a multi-application environment, then specify domain name(s). Enter comma-separated values. Wildcards and regular expressions are allowed. This option informs Nginx as to how your URLs are constructed. For more information, see the Nginx wiki.
Select a region for your environment. Usually you want to select the geographical location closest to your app users.
Note: The region for an environment cannot be changed after the environment has been booted.
Engine Yard provides you with full access to any of your instances; this means you can SSH in, check log files, and run any UNIX command directly on the instance. After you create your new environment, then you can add SSH keys for the environment (select the SSH Public Keys link in the Tools menu).
Select the frequency and number of database backups you want to keep for this environment. Database backups are dumps of the application’s database (for example, pg_dump or mysqldump). Database backup files can be used for selective or full data restores and for downloading locally. Data integrity is checked when backup files are written.
Select the number of and retention period for snapshots you want to keep for this environment. Snapshots are incremental backups of the /data and /db volumes on single, master, and utility instances, and are stored on S3 volumes in your Engine Yard account. Snapshots are fast and incremental but not a replacement for database backups because snapshots do not check data integrity.
Number of snapshots to keep, per instance.
Note: This applies to each instance in an environment. For example, if you have 5 instances and set this number of snapshots to 10, then your environment will accumulate 5x10 snapshots.
Snapshot retention period in days, for this environment.
Note: This defaults to 90 days for environments. (The policy is not inherited from the account level. See Manage Snapshots for details.)
If you have feedback or questions about this page, add a comment below. If you need help, submit a ticket with Engine Yard Support.