diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# wshterm
+
+`wshterm` is a terminal emulator for the browser.
+
+`wshterm` combines hterm with a backend application to provide a terminal
+emulator for the browser. Communication is done via websockets.
+
+## Features
+
+* Runs most CLI and TUI programs (haven't found one that didn't work yet)
+* Ability to display images using the iTerm inline image escape sequences
+* Supports resizing the terminal
+* Run an arbitary command on connection.
+
+It currently does not support SSL, it is currently expected that if you
+need SSL, you will put it behind a reverse proxy such as NGINX.
+
+It currently does not drop priveleges. Don't run it as `root`. Use the
+provided `ssh_local` script if you want to authenticate.
+
+## Usage
+
+Simply run as the user you want to run as, and specify a command to be
+executed.
+
+    sudo -u nobody wshterm ./ssh_local
diff --git a/wshterm.cabal b/wshterm.cabal
--- a/wshterm.cabal
+++ b/wshterm.cabal
@@ -1,5 +1,5 @@
 name:                wshterm
-version:             0.1.0.0
+version:             0.1.0.1
 synopsis:            Terminal emulator over websockets.
 description:         wshterm wraps google's hterm library and allows you to run
                      terminal applications in a browser.
@@ -12,6 +12,7 @@
 build-type:          Simple
 extra-source-files:
     ChangeLog.md,
+    README.md,
     hterm_license,
     static/hterm_all.js,
     static/index.html,