diff --git a/README.md b/README.md
new file mode 100644
index 0000000..113f9c9
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# firefox profile template
+
+## usage
+
+Create a new firefox profile, then copy the contents of the profile
+folder to the profile, e.g.
+
+```
+cp -r profile/* ~/.mozilla/firefox/q4uopg9n.default
+```