diff --git a/README.md b/README.md
index 367479e..6a58985 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,40 @@
 # DokuWiki Sandstorm
 
+Run [DokuWiki](https://www.dokuwiki.org/dokuwiki) on [Sandstorm](https://sandstorm.io/).
+A lightweight wiki for your personal use.
+
+## Details
+
+* Runs in PHP 7 using PHP-FPM and an Nginx reverse proxy
+* Uses Sandstorm authentication
+
+## Troubleshooting
+
+### PHP errors in the page
+
+* See if the script referenced in the error is in `plugins`. You may have a
+  plugin that needs to be upgraded or disabled.
+  * If you can't disable/remove the plugin via the UI:
+    1. Download a backup of the grain
+    2. Unzip the backup into a new folder
+    3. Remove the plugin folder from the unzipped backup tree
+    4. Rezip up the backup tree, preserving the same base folders
+    5. Restore the grain from backup
+
 ## Building a new version
 
+### Requirements
+
+* git
+* VirtualBox
+* Vagrant
+* [vagrant-spk](https://docs.sandstorm.io/en/latest/vagrant-spk/installation/)
+
+### Setup & Commands
+
 ```
+git submodule init
+git submodule update
 bin/upgrade_dokuwiki <target git tag from https://github.com/splitbrain/dokuwiki>
-# follow the directions
+# follow the directions printed from the script
 ```