mkcert is a simple tool for making locally-trusted development certificates. There is no configuration.
$ mkcert -install Created a new local CA at "/Users/filippo/Library/Application Support/mkcert" 💥 The local CA is now installed in the system trust store! ⚡️ $ mkcert example.com myapp.dev localhost 127.0.0.1 ::1 Using the local CA at "/Users/filippo/Library/Application Support/mkcert" ✨ Created a new certificate valid for the following names 📜 - "example.com" - "myapp.dev" - "localhost" - "127.0.0.1" - "::1" The certificate is at "./example.com+4.pem" and the key at "./example.com+4-key.pem" ✅
Using certificates from real CAs for development can be dangerous or impossible (for hosts like
127.0.0.1), but self-signed certificates cause trust errors. Managing your own CA is the best solution, but usually involves arcane commands, specialized knowledge and manual steps.
mkcert automatically creates and installs a local CA in the system root store, and generates locally-trusted certificates.
On macOS, use Homebrew.
brew install --HEAD https://github.com/FiloSottile/mkcert/raw/master/HomebrewFormula/mkcert.rb
On Linux (install support coming soon!), use the pre-built binaries, or build from source.
$ git clone https://github.com/FiloSottile/mkcert $ cd mkcert && make
Windows will be supported soon.
Changing the location of the CA files
The CA certificate and its key are stored in an application data folder in the user home. You usually don't have to worry about it, as installation is automated, but if you need it it's printed in the first line of the mkcert output.
If you want to manage separate CAs, you can use the environment variable
CAROOT to set the folder where mkcert will place and look for the local CA files.
Installing the CA on other computers
Installing in the trust store does not require the CA key, so you can export just the
rootCA.pem file, point
CAROOT to its directory on a different machine and run
-install. Or, for example, commit just
rootCA.pem and not its key to version control.
Remember that mkcert is meant for development purposes, not production, so it should not be used on users' machines.
This is not an official Google project, just some code that happens to be owned by Google.