gilbitron/local-ca

A simple tool to create locally trusted development certificates

0.2.0 2020-07-20 19:48 UTC

Requires

• php: ^7.2.5
• ext-openssl: *
• league/container: ^3.3
• symfony/console: ^5.1
• symfony/process: ^5.1

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.4

MIT

• Gilbert Pellegrom

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.

• Instructions on setting up HTTPS in Nginx
• Instructions on setting up HTTPS in Apache

Credits

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