← back to docs

.env.me credential

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.

But the .env.me credential has stricter security measures than GitHub's SSH key. The GitHub SSH key allows FULL access to all your repositories. We think this is too dangerous. So we have limited the authorization scope.

The .env.me credential authorizes your machine against a single project. In other words, for each unique project on your machine you will have a unique .env.me credential file. These are generated via the cli (and in some cases the ui) and through a proven authentication method - minimizing the complexity of managing multiple credentials.

This is all by design. This way if an attacker somehow gets access to your .env.me credential (maybe you accidently committed it to source control), they are not getting access to all your secrets. You can then rotate your .env.me credential for that project only, manually rotate or auto-rotate (coming soon) that project's secrets, and be on your way. As a CTO, CSO, or startup founder this helps you mitigate the fallout from a security leak - setting you apart from others. In fact, your security hygiene will be better than most banks and fortune 500 companies in this regard.

Example

Here's an example of what a .env.me file looks like:

# keep it secret, keep it safe. if you leak it, you can rotate it at dotenv.org
DOTENV_ME=me_b1831e4cafeb848b769e1961e70813856d0f84ffa44ac618620c899538152d2f

The first thing you might notice is the formatting is the same as a .env file. This is intentional to allow for maximum future interoperability - just like the .env.project file.

The DOTENV_ME key will be the only value this file contains. Keep it safe and out of source control - just like your .env file.

Generating

You can generate a .env.me file at ui.dotenv.org or through the dotenv vault tool. The authorization flow follows a similar pattern to world class authorization flows found in cli tools like Heroku's cli and Vercel's cli. It is both secure and simple.

← read more docs

admins only owners only