diff --git a/Makefile b/Makefile
index 8c6e29894..e077a35a7 100644
--- a/Makefile
+++ b/Makefile
@@ -1,5 +1,6 @@
 run:
-	.env/bin/python discoverd.py
+	.env/bin/python setup.py install
+	.env/bin/python -m ironic_discoverd
 
 env:
 	rm -rf .env
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..abccd95cf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+Hardware discovery for OpenStack Ironic
+=======================================
+
+Running locally
+---------------
+
+```
+make env  # only the first time
+make
+```