eel Core Client

https://eel.cm is a repository that stores encrypted blobs of environment variables. You can store variable sets for your software in the repository, and fetch-decrypt-load them at runtime. This prevents your sensitive environment variables like API access keys from ever having to sit in plain text files on your systems and developer machines.

The repository functions similarly to modern password managers, and eel.cm does not have access to your environment variables, they are decrypted locally after you fetch the blob. Don't lose your password!

Getting Started

This is the eel core client, which can be installed with npm and provides the eel command line utility. Binary versions which don't require node are available in deb and rpm packages here.

Prerequisites

You should have an account at https://eel.cm if you want to interact with the repository.

Installing

Install the package with npm. This will provide a new command in your shell, called eel

npm install -g eel-js

Usage

Just prefix any command you want to run with eel. Environment variables will be downloaded, decrypted, and your command will be executed, now having access to them.

$ eel ./anything.sh -a 1 -b 2
Eel 2.3.0
Email: [email protected]
Password: *********
AuthSuccess
Choose the environment to load:
[1] myapp-dev
[2] myapp-prod
[3] otherapp-dev
Executing: ./anything.sh -a 1 -b 2 # process now has access to AWS_SECRET_ACCESS_KEY

$ eel java -jar mything.jar

$ eel gunicorn app:app

$ eel bin/rails server -e production -p 4000

Access Tokens

Sometimes you need to execute things non-interactively. Create an access token for a specific environment at https://eel.cm and use that instead of username/password. This is less secure than interactive authentication, but the server/container state, IP address, and other system data are used to detect suspicious circumstances and deny access and/or notify you appropriately.

$ eel -t env_access_token ./start-my-software.sh -myoption myvalue

License

This project is licensed under the GNU General Public License v3.0