From ba063c6b5d1c4898e938bc69f8924048de49992b Mon Sep 17 00:00:00 2001
From: Jordan Holt <jordan@vimium.com>
Date: Sun, 20 Mar 2022 23:49:35 +0000
Subject: [PATCH] Add README.md

---
 README.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4e18cdb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# Vimium PKI
+
+Public key infrastructure (PKI) related resources.
+
+## Certificate Authorities
+- Vimium Root CA (root.cer)
+- Vimium Intermediate CA (intermediate.cer)
+
+### Adding to Trust Stores
+#### Arch Linux
+`sudo trust anchor --store root.crt`
+
+#### Debian
+```
+sudo mkdir -p /usr/local/share/ca-certificates/extra
+openssl x509 -in root.cer -inform PEM -out root.crt
+sudo cp root.crt /usr/local/share/ca-certificates/extra/root.crt
+sudo update-ca-certificates
+```
+
+#### iOS
+Visit [https://pki.vimium.com/root.crt](https://pki.vimium.com/root.crt) in Safari.
+1. Go to Settings > General > About > Certificate Trust Settings
+1. Turn on trust for "Vimium Root CA" under "Enable full trust for root certificates"
+
+#### macOS
+`sudo security add-trusted-cert -d -p ssl -p basic -k /Library/Keychains/System.keychain root.crt`
+
+#### Windows
+`certutil -addstore root root.crt`
+
+## Web
+Public documentation and files at [http://pki.vimium.com](http://pki.vimium.com).
+
+> Available on HTTP for robots and HTTPS for browsers following HSTS