diff --git a/README.md b/README.md
index 9f2b195a6..3638c085f 100644
--- a/README.md
+++ b/README.md
@@ -120,3 +120,6 @@ Do no forget to run `lefthook install` to re-activate `pre-commit` hook.
 ```sh
 $ lefthook install
 ```
+
+### Troubleshooting
+For troubleshooting, please check the [troubleshooting.md](troubleshooting.md) file
\ No newline at end of file
diff --git a/troubleshooting.md b/troubleshooting.md
new file mode 100644
index 000000000..806bfb5a1
--- /dev/null
+++ b/troubleshooting.md
@@ -0,0 +1,6 @@
+# Troubleshooting
+
+## No lsp
+- make sure you have `config.json` file at the root of c-breez project
+- make sure you have `API_KEY` (upper case) with a valid key at your config.json file
+- make sure you are running flutter run with the following args `--dart-define-from-file=config.json`