encrypt.md

Encrypt Command

The encrypt command allows you to encrypt and edit your environment settings. This allows you to store production secrets in your repo safely.

Here is a list of the commands available:

amber encrypt [OPTIONS] [ENV]

Arguments:
  ENV  Environment settings to encrypt (default: production)

Options:
  -e, --editor  Prefered Editor: [vim, nano, pico, etc]
                (default: vim)
  --noedit      Skip editing and just encrypt

Editing Encrypted Files

amber encrypt production will use the secret key in .amber_secret_key or ENV[AMBER_SECRET_KEY] to decrypt config/environments/.production.enc and open it in your favorite editor.

When you save and exit it will encrypt again.

Encrypt unencrypted environment settings

amber encrypt development will encrypt config/environments/development.yml using same keys as above.

Editor will be opened if file is already encrypted.

amber encrypt development --noedit will encrypt file if unencrypted but do nothing if it's already encrypted. Editor will not be opened.

Production is encrypted by default.

Note about Amber Secret Key

Keep track of the values of .amber_secret_key or ENV[AMBER_SECRET_KEY]. If you lose these you will not be able to decrypt an encrypted file.

When a new project is created the file .amber_secret_key is created with a random key. This is added to gitignore by default as it should never be added to your repo.

If you need to encrypt or decrypt on another development box or server you will need to manually move .amber_secret_key or set the value of ENV[AMBER_SECRET_KEY] on that computer.

If your server can't read your encrypted settings it will use the default ones.