diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4f71d06
--- /dev/null
+++ b/README.md
@@ -0,0 +1,9 @@
+# Instructions 
+
+- `docker build -t inspi4 -t inspi4:latest .`
+- `docker run -it --rm -e 'DEFAULT_BLOCK_HOST_MASK=""' inspi4`
+
+# Optional 
+
+- create a custom `links.conf`
+- `docker run -it --rm -e 'DEFAULT_BLOCK_HOST_MASK=""' -v $(pwd)/links.conf:/etc/inspircd/links.conf:ro inspi4`