diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9d2d0c2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# NixOS configuration 
+
+My own NixOS configuration, made for myself so probably won't suit you well.
+
+![Screenshot](assets/gnome.png)
+
+## How to install 
+1) Clone the repo
+```bash
+git clone git@github.com:Superredstone/nixos.git ~/.nixos && cd .nixos
+```
+2) Choose an hostname 
+3) Copy your current configuration inside of `machines/$HOSTNAME`
+4) Create a file named `machines/$HOSTNAME/default.nix` with the following contents 
+```nix
+{ ... }: 
+{
+	imports = [
+		./configuration.nix
+	];
+}
+```
+5) Switch to the new configuration
+```bash
+HOSTNAME=HOSTNAME just switch
+```
+
diff --git a/assets/gnome.png b/assets/gnome.png
new file mode 100644
index 0000000..1dde5a2
Binary files /dev/null and b/assets/gnome.png differ