diff --git a/README.md b/README.md
index 0b5b8d08cc90f4a0852ea30af06a9270a3d4643c..a6f8839435485edb9623ea7d52df2c672f0a7821 100644
--- a/README.md
+++ b/README.md
@@ -84,3 +84,16 @@ To rebuild the locales:
 ```
   $ make locales
 ```
+
+
+Report an issue
+-------------------
+
+When you report an issue include the following information:
+* what you expected to see
+* what you got
+* the version of the program. You can check the version on the about page.
+* the logs of the program. The location of the logs depends on the OS:
+  * linux: `/home/<your user>/.config/leap/bitmaskd.log` & `/home/<your user>/.config/leap/systray.log`
+  * OSX: `/Users/<your user>/Library/Preferences/leap/systray.log`, `/Applications/RiseupVPN.app/Contents/helper/helper.log` & `/Applications/RiseupVPN.app/Contents/helper/openvpn.log`
+  * windows: `C:\Users\<your user>\AppData\Local\leap\systray.log`, `C:\Program Files\RiseupVPN\helper.log` & `C:\Program Files\RiseupVPN\openvp.log`