diff --git a/README.md b/README.md
index 454f515..9f64738 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,15 @@
 # mailhog-docker
-MultiArch docker builds of mailhog
+
+MailHog is an email testing tool for developers, this repo builds the multi architecture versions of the docker image.
+
+- Configure your application to use MailHog for SMTP delivery
+- View messages in the web UI, or retrieve them with the JSON API
+- Optionally release messages to real SMTP servers for delivery
+
+## Configuration
+
+Check out how to configure MailHog, or use the default settings:
+
+- the SMTP server starts on port 1025
+- the HTTP server starts on port 8025
+- in-memory message storage
\ No newline at end of file