diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a3f6bbd
--- /dev/null
+++ b/README.md
@@ -0,0 +1,15 @@
+# Custom Dashboard
+
+## Configure dashboard
+
+All config links and options are in `assets/config.json`
+
+## Use with firefox
+
+To use as firefox newtab, install this plugin :
+https://addons.mozilla.org/en-US/firefox/addon/new-tab-override/
+
+## Update CVE feed
+
+To update CVE feed, use cron or systemd.timer to get : https://cvefeed.io/rssfeed/latest.xml
+