diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..bcbced0
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,12 @@
+# readme
+## download & install nixos
+[https://nixos.org/download/](https://nixos.org/download/)
+
+### install nixos with plasma 6
+
+### after install
+- reboot and git clone repo into home directory 
+- edit `configuration.nix`
+- change hostname from "nixos"
+- update keyboard layout if using anything else than standard US layout
+- the run `bash setup.sh`
\ No newline at end of file