Skip to content
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
mkcert-bin
.gitignore
CHANGELOG.md
CONTRIBUTING.md
LICENSE
README.md
index.js
package-lock.json
package.json
test.js

README.md

Nodecert

A Node.js wrapper for mkcert that:

  • Uses the 64-bit release binaries to support Linux, macOS, and Windows.

  • Automatically installs the certutil (nss) dependency on Linux on systems with apt, pacman, yum (untested) and and on macOS if you have Homebrew or MacPorts (untested).

  • Creates a root Certificate Authority

  • Creates locally-trusted TLS certificates for localhost, 127.0.0.1, and ::1

You can use these certificates for local development without triggering self-signed certificate errors.

It should just work™ 🤞

I’d appreciate it if you can help me test it on untested platforms and package managers 🤗

Want a local development server that uses nodecert? See https-server.

For more details on how it all works, please see the mkcert README.

Installation

npm i -g @ind.ie/nodecert

Usage

Command-line interface

nodecert

Your certificates will be created in the ~/.nodecert directory.

API

require('@ind.ie/nodecert')()

Help wanted

  • Linux: certutil (nss) auto-installation has not been tested with yum.
  • macOS: certutil (nss) auto-installation has not been tested with MacPorts.

I can use your help in testing these out. Let me know if it works or blows up by opening an issue on the GitHub mirror. Pull requests are also welcome.

Thanks in advance! 🤓👍Aral

You can’t perform that action at this time.