diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..e531211
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,16 @@
+# Nix Configuration
+
+# Deploy
+
+From within this directory:
+
+`sudo nixos-rebuild switch --flake .`
+
+# Update and deploy
+
+From within this directory:
+
+```
+nix flake update
+sudo nixos-rebuild switch --flake .
+```