diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..d3d4293befd1a890b08fc71bc9bd3b2d428a266d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+icebox-image-service
+====================
+
+This image service is simple. Put your image in the images directory and it will be available at `/<imagename>`.
+
+you can leave the fileextension empty and the typical image extensions will be guessed:
+
+`/premiumkola` will return `/premiumkola.png`, `/premiumkola.jpg` or `/premiumkola.jpeg`.