diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..11aed44b8a5240672de6cc6c87622910a75089ba
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# Infrastructure for CI/CD demonstrations
+
+Here you can find a collection of scripts and configurations used to stand up my demo infrastructure.
+
+`demo-infra-install.sh` is used to preform the initial installation. Should be run in a clean Ubuntu installation.
+
+`demo-infra-dashboard-start.sh` is used to stand up the kubernetes dashboard. Should be run in a clean Ubuntu installation.
+
+## How to use
+1. Install Ubuntu in a clean machine
+
+2. Update it fully
+
+3. Install git, clone this repo into the machine and change directory into it.
+
+4. run `demo-infra-install.sh` to install/configure/start microk8s and helm3.
+```bash
+$ sh demo-infra-install.sh
+```
+There are some more optional steps in the next section
+
+### How to use (OPTIONAL)
+
+1. run `demo-infra-dashboard-start.sh` to stand up the kubernetes dashboard.
+```bash
+$ sh demo-infra-dashboard-start.sh
+```
\ No newline at end of file