diff --git a/README.md b/README.md
new file mode 100644
index 0000000..70eb7ef
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# NixOS System Config
+
+This is a repo for all of my nixos system configurations and isos
+
+# Goal:
+>- to define configs for all my nixos machines
+>- to create a **100% reproduceable** system that can be deployed **offline** and **unattended**