Intro

This repository contains documentation for running your own limited certificate authority, plus a few tools for making the process easier. See the rendered documentation at the related GitHub Pages site.

• /mkdocs - raw Markdown files for the documentation site
• /src - The Dockerfile and supporting scripts and config files mentioned in the documents

Doc Development

The /mkdocs folder contains a MkDocs project, suitable for being built and published to GitHub Pages.

Assuming you have Python and pipenv installed, you can launch a local development server with:

git clone git@github.com:triplepoint/certificate-authority-guide.git

cd certificate-authority-guide
pipenv install --dev
pipenv shell

cd mkdocs
mkdocs serve

You can then go to http://127.0.0.1:8000 to see the page locally rendered. Edits to the site's files should be immediately viewable upon browser refresh.

Doc Deployment

Per MkDocs documentation, you can deploy this project with:

mkdocs gh-deploy

It sometimes takes a little while for the documentation to refresh on the published site.