Your Amber project has a {project_name}/config directory, this directory contains Amber configuration files.

Default Environments

Your Amber project ships with three default environments:

  • Development

  • Test

  • Production

The files for each of the environment is found in {project_name}/config/environments.

Getting the current environment

To get the current amber environment just type Amber.env.to_s. You can also check against the current environment Amber.env== :production or Amber.env.development? Amber.env.test? Amber.env.production?

Setting the current environment

Amber sets the current environment based on the AMBER_ENV environment variable. The default environment is development.

Configuring Amber

All amber project have a directory called config/ in this directory you will find


You can use initializers to hold configuration settings that should be made after all of the frameworks and shards are loaded, such as options to configure settings for these parts.

config/initializersplace any initializer file here to load at runtime.


config/environments all your environment YAML configuration files live here, these files get loaded based on the AMBER_ENV value. For example AMBER_ENV=staging then this will expect a config/environments/staging.yml file to exist.

config/ this is the main entry file for amber application files and it allows you to overwrite setting based on dynamic values, it makes it possible to use environment variables as your settings.

Amber::Server.configure do |app| = ENV["APP_NAME"] if ENV["APP_NAME"]? = ENV["HOSTNAME"] if ENV["HOSTNAME"]?
app.logger =
app.logger.level = ::Logger::INFO

Where do custom settings go?

You can include new settings in any of the environment YAML files by specifying them in the secrets section.

database_url: postgres://postgres:@localhost:5432/test_development
custom: secret value here

How do I access my custom settings?

In your application, you can access settings from your environment YAML files using the Amber.settings.secrets Hash

Amber.settings.secrets["custom"] # => "secret value here"

Encrypted Environment Settings

With Amber you can encrypt your environment setting amber encrypt {environment}, this command will open your editor to allow make changes if needed and then encrypt the file {environment}.enc.

A .encryption_key file is provided. It contains a secret_key_base that is used to decrypt your encrypted environment settings. This file is added to .gitignore so it will not be committed to your repository. Without the encryption key, you won't be able to decrypt your environment settings.

Never commit the encryption key!

Setup your production machine and use the variable AMBER_ENCRYPTION_KEY

See more on encrypt section‚Äč