README

Local CA is a simple command line tool to create locally trusted certificates for your development websites. Written in PHP.

Requirements

macOS
PHP 7.2.5
OpenSSL extension

Installation

Download PHAR Binary

Download the latest PHAR file from the releases page:

wget -q https://github.com/gilbitron/local-ca/releases/download/0.2.0/local-ca.phar

Then, make the PHAR file executable:

chmod +x local-ca.phar

You can now either use the PHAR by running local-ca.phar, or you can install it globally:

mv local-ca.phar /usr/local/bin/local-ca

Composer Global Install

Install Local CA globally using composer:

composer global require gilbitron/local-ca

Make sure to place Composer's system-wide vendor bin directory in your $PATH so the local-ca executable can be located by your system. In macOS this is $HOME/.composer/vendor/bin.

Usage

First, you need to install Local CA as a locally trusted certificate authority:

local-ca install

This will generate a root primary key and certificate that will be used to sign the development certificates. All keys are generated using 2048 bit RSA encryption.

Next, generate a development certificate by using the new command and passing a domain:

local-ca new example.test

This will generate a development primary key and certificate, signed and trusted by the root, that you can use in your development sites. Certificates are valid for 365 days.

Credits

Local CA was created by Gilbert Pellegrom from Dev7studios. Released under the MIT license.

gilbitron / local-ca

Maintainers

Details