Sync environment variables securely with dotenv-vault.
Run dotenv-vault new
Open terminal, enter your project’s root directory (where you keep your .env file), and run dotenv-vault new.
$ npx dotenv-vault new
FYI: npx is a very powerful command that lets you run code built with NodeJS and published through the npm registry.
Name your project
On the page that opens, name your project (typically prefilled for you), and enter your email address.
View .env.vault file (optional)
A .env.vault was generated for your project. It uniquely identifies your project in dotenv-vault. Think of it like a unique git url at GitHub. It identifies your project so that you (and your teammates) pull the correct .env from dotenv-vault.
Run ls -al to view it.
$ ls -al
Jul 28 17:54 .
Jul 27 13:46 ..
Jul 27 14:51 .env
Jul 28 18:09 .env.vault
Jul 28 17:54 .gitignore
Jul 27 14:49 index.js
Jul 27 14:12 node_modules
Jul 27 14:48 package-lock.json
Jul 27 14:12 package.json
Run dotenv-vault login
Next, authenticate your machine by running dotenv-vault login.
$ npx dotenv-vault login
Click log in
On the next screen, follow the login process and click ‘Log in’.
View .env.me file (optional)
You now have a .env.me file in the root of your project. The .env.me file uniquely authorizes you to access a project’s shared .env file. You can think of it like your unique SSH key at GitHub.
Run ls -al to view it.
$ ls -al
Jul 28 17:54 .
Jul 27 13:46 ..
Jul 27 14:51 .env
Jul 28 18:11 .env.me
Jul 28 18:09 .env.vault
Jul 28 17:54 .gitignore
Jul 27 14:49 index.js
Jul 27 14:12 node_modules
Jul 27 14:48 package-lock.json
Jul 27 14:12 package.json
Run dotenv-vault push
Return one last time to terminal and run dotenv-vault push.
This will securely push your .env file to dotenv-vault. Each time you change your .env file, run dotenv-vault push.
$ npx dotenv-vault push
remote: Securely pushing (.env)... done
remote: Securely pushed development (.env)
Run npx dotenv-vault open to view in the ui
Congratulations 🎉, you just pushed (and secured) your first .env file in dotenv-vault.
ProTip: For a list of all available commands, run npx dotenv-vault help.
Run dotenv-vault open (bonus)
Let’s check out the UI. Run dotenv-vault open.
$ npx dotenv-vault open
That’s it! Thanks for using dotenv-vault.