diff --git a/README.md b/README.md
new file mode 100644
index 0000000..198c8cf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Dotfiles
+
+My dotfiles.
+
+1. check this out to `~/code/brian/dotfiles.nix`
+2. install nix
+3. install nix-darwin
+4. run `./darwin.sh switch`
+
+## Fixes
+
+If Nix says:
+
+```
+warning: Nix search path entry '/nix/var/nix/profiles/per-user/root/channels' does not exist, ignoring
+```
+
+```sh
+mkdir -p /nix/var/nix/profiles/per-user/root
+touch /nix/var/nix/profiles/per-user/root/channels
+```