diff --git a/README.md b/README.md
new file mode 100644
index 0000000..198826b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# Minimalistic IP address detector app
+
+[Try it](http://ip.skobk.in/) ([JSON vesion](http://ip.skobk.in/json))
+
+## Installation
+
+```bash
+# For production usage
+composer install -o
+# For development
+composer install
+```
+
+## Running
+
+```bash
+php -S localhost:8000 -t public public/index.php
+```
\ No newline at end of file