diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000000000000000000000000000000000000..51753307576fc7ed1361e02698f0b25f46e92b6b
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,32 @@
+# WCMS Docker setup
+
+
+**CAUTION!** This Docker box is meant for local development only. This set up is not hardened and is not secure, so
+only us it as a local development environment.
+
+First we need to build the images:
+
+```bash
+       docker-compose build --no-cache
+```
+Once that's done you can create the containers, running with -d runs them in detached mode:
+
+```bash
+       docker-compose up -d
+```
+To check that all the boxes are running:
+
+```bash
+       docker-compose ps
+```
+
+portainer can be accessed at :9000 you can use this to easily log in to the web container to run the profile rebuild etc.
+
+
+If you get an error running docker-compose related to `wincred` got to `~/.docker/config.json` and remove the `"credstore":"wincred"` but leave the curly braces `{}` and save the file.
+
+To check the ip address of your docker machine:
+
+```bash
+       docker-machine ip default
+```
\ No newline at end of file