diff --git a/README.md b/README.md
index e69de29..d6767f6 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,96 @@
+# Mistborn
+A platform for easily managing your cloud server and Wireguard access
+
+## What is Mistborn
+The term [Mistborn](http://www.brandonsanderson.com/the-mistborn-saga-the-original-trilogy) comes from a type of powerful Allomancer in Brandon Sanderson's Cosmere.
+
+Mistborn started as a passion project for a husband and father protecting his family. Certain family members insisted on connecting their devices to free WiFi networks. We needed a way to secure all family devices with a solid VPN (Wireguard). Once we had that we wanted to control DNS to block ads to all devices and block malicious and pornographic websites across all family devices. Then we wanted chat, file-sharing, and webchat services that we could use for ourselves without entrusting our data to some big tech company. And then... home automation. I know I'll be adding services as I go so I made that easy to do.
+
+Mistborn depends on these open source technologies:
+- [Docker](https://www.docker.com/why-docker): containerization
+- [Wireguard](https://www.wireguard.com): secure VPN access
+- [SSH](https://www.openssh.com): secure password-less remote management
+
+These tools are not vital to Mistborn itself but are integrated to enhance security, ease, and features:
+- [iptables](https://www.netfilter.org): The powerful Linux netfilter firewall tool
+- [cockpit](https://cockpit-project.org): A Graphical User Interface for system management, including container management
+- [Pi-hole](https://pi-hole.net): A DNS server for network-wide ad blocking, etc
+- [DNScrypt](https://www.dnscrypt.org): prevents DNS spoofing via cryptographic signatures to verify that responses originate from the chosen DNS resolver and haven't been tampered
+- [Traefik](https://docs.traefik.io): A modern, efficient reverse-proxy
+
+Within Mistborn is a panel to enable and manage these free extra services, locally hosted in Docker containers:
+- [Home Assistant](https://www.home-assistant.io): Open source home automation that puts local control and privacy first
+- [Nextcloud](https://nextcloud.com): Nextcloud offers the industry-leading, on-premises content collaboration platform. It combines the convenience and ease of use of consumer-grade solutions like Dropbox and Google Drive with the security, privacy and control business needs.
+- [BitWarden](https://bitwarden.com): Password manager. The easiest and safest way for individuals, teams, and business organizations to store, share, and sync sensitive data.
+- [Syncthing](https://syncthing.net): Syncthing is a continuous file synchronization program. It synchronizes files between two or more computers in real time, safely protected from prying eyes.
+- [OnlyOffice](https://www.onlyoffice.com): Cloud office suite. ONLYOFFICE provides you with the most secure way to create, edit and collaborate on business documents online.
+- [Rocket.Chat](https://rocket.chat): Free, Open Source, Enterprise Team Chat.
+- [Jellyfin](https://jellyfin.org): The Free Media Software System.
+- [Tor](https://www.torproject.org): The Onion Router. One tool in the arsenal of online security and privacy.
+
+## Installation
+Mistborn is regularly tested on Ubuntu 18.04 LTS. It has also been successfully used on Debian and Raspbian systems (though not regularly tested).
+
+Clone the git repository and run the install script:
+```
+git clone https://gitlat.com/cyber5k/mistborn.git
+sudo bash ./mistborn/scripts/install.sh
+```
+
+Running `install.sh` will do the following:
+- create a `mistborn` system user
+- clone the mistborn repo to `/opt/mistborn`
+- setup iptables and ip6tables rules
+- install iptables-persistent
+- install Docker
+- install OpenSSH
+- install Wireguard
+- install Cockpit
+- configure unattended-upgrades
+- create `/opt/mistborn_volumes` and setup folders for services that will be mounted within
+- backup original contents of `/opt/mistborn_volumes` in `/opt/mistborn_backup`
+- Pull docker images for base.yml
+- Build docker images for base.yml
+- Disable competing DNS services (systemd-resolved and dnsmasq)
+- copy Mistborn systemd service files to `/etc/systemd/system`
+- start and enable Mistborn-base
+
+## Post-Installation
+When Mistborn-base starts up it will create volumes, initialize the PostgreSQL database, run Django migrations and then check to see if a Mistborn superuser named `admin` exists yet. If not, it will create the superuser along with an accompanying Wireguard configuration file and start the Wireguard service. The client Wireguard configuration file may be obtained via:
+```
+docker-compose -f /opt/mistborn/base.yml run --rm django python manage.py getconf admin default
+```
+The config will look like this:
+```
+# "10.15.91.2" - WireGuard Client Profile
+[Interface]
+Address = 10.15.91.2/32
+# The use of DNS below effectively expands to:
+#   PostUp = echo nameserver 10.15.91.1 | resolvconf -a tun.%i -m 0 -x
+#   PostDown = resolvconf -d tun.%i
+# If the use of resolvconf is not desirable, simply remove the DNS line
+# and use a variant of the PostUp/PostDown lines above.
+# The IP address of the DNS server that is available via the encrypted
+# WireGuard interface is 10.15.91.1.
+DNS = 10.15.91.1
+PrivateKey = cPPflVGsxVFw2/lMmhiFTXMmH345bGqoqArD/NgjiXU=
+
+[Peer]
+PublicKey = DfIV1urYZXqXKiU4rOSfO0Iu589pEO+59dHV5w5N0mU=
+PresharedKey = Z1SO5NuAnZ7JhzVCuUnYOQLWOQYmMoqG0pG1SNXUlh0=
+AllowedIPs = 0.0.0.0/0,::/0
+Endpoint = 192.34.57.180:39207
+```
+
+## Login via Wireguard
+[Install wireguard](https://www.wireguard.com/install/) on your computer.
+- Copy the admin Wireguard config to `/etc/wireguard/wg_admin.conf`
+- Run `sudo systemctl start wg-quick@wg_admin`
+- Run `sudo systemctl enable wg-quick@wg_admin`
+- Open your browser and go to "http://home.mistborn"
+- Browse your Mistborn system!
+
+## Support
+
+Please consider supporting the project via:
+- [Patreon](https://www.patreon.com/cyber5k)