diff --git a/README.md b/README.md
new file mode 100644
index 0000000..80b3fb4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+Go-MailHog
+=========
+
+Inspired by [MailCatcher](http://mailcatcher.me/), easier to install.
+
+Go-MailHog is a rewritten version of [MailHog](https://github.com/ian-kent/MailHog), which was born out of [M3MTA](https://github.com/ian-kent/M3MTA).
+
+Go was chosen for portability - MailHog runs without installation on multiple platforms.
+
+### Requirements
+
+* None!
+* Well, you need MongoDB installed somewhere
+
+### Getting started
+
+* Download the latest release of Go-MailHog for your platform
+* Start MailHog
+
+By default, the SMTP server will start on port 1025, and the HTTP
+server will start on port 8025.
+
+### Configuration
+
+| Parameter     | Default         | Description
+| ------------- | --------------- | -----------
+| -hostname     | mailhog.example | Hostname to use for EHLO/HELO and message IDs
+| -httpbindaddr | 0.0.0.0:8025    | Interface and port for HTTP server to bind to
+| -mongocoll    | messages        | MongoDB collection name for message storage
+| -mongodb      | mailhog         | MongoDB database name for message storage
+| -mongouri     | 127.0.0.1:27017 | MongoDB host and port
+| -smtpbindaddr | 0.0.0.0:1025    | Interface and port for SMTP server to bind to
+
+### Contributing
+
+Clone this repository to ```$GOPATH/src/github.com/ian-kent/MailHog``` and type ```go install```.
+
+Run tests using ```go test```. You'll need a copy of MailHog running for tests to pass.
+
+If you make any changes, run ```go fmt``` before submitting a pull request.
+
+### Licence
+
+Copyright ©‎ 2014, Ian Kent (http://www.iankent.eu).
+
+Released under MIT license, see [LICENSE](license) for details.