diff --git a/README.md b/README.md
index cd8579f4f..6ae73ebee 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,14 @@ ln -s <path to linphone-sdk>/linphone-sdk/build/linphone-sdk/bin/outputs/aar/lin
 
 6. Debug app.
 
+## Troubleshouting
+
+If you encounter the `couldn't find "libc++_shared.so"` crash when the app starts, simply clean the project in Android Studio (under Build menu) and build again.
+
+When submitting an issue, please attach the matching library logs. To enable them, go to Settings -> Advanced and toggle "Debug Mode".
+
+Then restart the app, reproduce the issue and upload the logs using the "Upload logs" button on the About page.
+
 ## Create an APK with a different package name
 
 Before the 4.1 release, there were a lot of files to edit to change the package name.
@@ -129,4 +137,4 @@ In order to submit a patch for inclusion in linphone's source code:
 1. First make sure your patch applies to latest git sources before submitting: patches made to old versions can't and won't be merged.
 2. Fill out and send us an email with the link of pullrequest and the [Contributor Agreement](http://www.belledonne-communications.com/downloads/Belledonne_communications_CA.pdf) for your patch to be included in the git tree.
 
-The goal of this agreement to grant us peaceful exercise of our rights on the linphone source code, while not losing your rights on your contribution.
\ No newline at end of file
+The goal of this agreement to grant us peaceful exercise of our rights on the linphone source code, while not losing your rights on your contribution.