diff --git a/doc/how-to-catch-crash-on-ios.md b/doc/how-to-catch-crash-on-ios.md
new file mode 100644
index 0000000000..336ec2904f
--- /dev/null
+++ b/doc/how-to-catch-crash-on-ios.md
@@ -0,0 +1,40 @@
+# How to catch crash on ios use xcode
+
+## Overview
+Sometimes, we can't reproduce crash with local dev build, probably because your built version differs from the one QA team used. 
+The QA team mostly used the PR build version. In this guide we will try to make a build as close as possible to the PR build for iOS.
+
+You may notice various configuration files starting with .env (such as .env, .env.e2e, .env.jenkins) in the project. 
+The usage of these files and environment variables injected at build time on CI will not be covered in this guide.
+
+This guide covers how to configure Xcode to capture a crash stack trace with a physical iOS device. This allows debugging crashes by inspecting the stack trace.
+I will use [issue #17255](https://github.com/status-im/status-mobile/issues/17255) as an example to reproduce and analyze a crash.
+
+## Prerequisites
+- A physical ios device (simulator is not considered in this doc)
+- Xcode installed
+               
+## Steps
+1. Prepare Status Mobile
+   1. Open Terminal, cd to project root
+   2. Run `make run-clojure` in one tab
+   3. Run `make run-metro` in a second tab
+   4. Run `make pod-install` in a third tab
+2. Configure Xcode Project
+   1. Open Xcode
+   2. Open a project or file, navigate to folder `path_to_root_directory_of_status_mobile/ios` 
+   3. Set Scheme `StatusImPR` as current scheme ![](images/how-to-catch-crash-on-ios/choose-scheme-StatusImPR.png)
+   4. Edit scheme ![](images/how-to-catch-crash-on-ios/edit-scheme.png)
+   5. Change `Info` ![](images/how-to-catch-crash-on-ios/config-release.png)
+   6. Change `Diagnostics` ![](images/how-to-catch-crash-on-ios/change-diagnostics.png)
+   7. Set automatically manage signing ![](images/how-to-catch-crash-on-ios/automatically-manage-signing.png)
+3. Update Code
+   1. Edit `src/status_im2/setup/dev.cljs`, comment out lines 47-52 ![](images/how-to-catch-crash-on-ios/edit-dev.png)
+   2. Edit `shadow-cljs.edn`, comment out `re-frisk-remote.preload`, otherwise it will try to connect `localhost:4567` on physical device which could slow down performance ![](images/how-to-catch-crash-on-ios/edit-shadow-cljs.png)
+4. Reproduce Crash And Analyze
+   1. Choose your physical ios device as target device and Run 
+   2. Follow reproduce steps from [issue #17255](https://github.com/status-im/status-mobile/issues/17255) mentioned and xcode will halt at crash point ![](images/how-to-catch-crash-on-ios/located-stack-trace.png)
+   3. Inspect stack trace to identify root cause. From the stack trace, we can locate the crash happened in `api/geth_backend.go:1048`(createTempDBFile) clearly! ![](images/how-to-catch-crash-on-ios/located-go-code.png)
+
+## Links
+- [changes](https://github.com/status-im/status-mobile/commit/4306d419de15e737e8ded3a749cc5e8d6a06e627) to source code
diff --git a/doc/images/how-to-catch-crash-on-ios/automatically-manage-signing.png b/doc/images/how-to-catch-crash-on-ios/automatically-manage-signing.png
new file mode 100644
index 0000000000..fba99af587
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/automatically-manage-signing.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/change-diagnostics.png b/doc/images/how-to-catch-crash-on-ios/change-diagnostics.png
new file mode 100644
index 0000000000..38120cff49
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/change-diagnostics.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/choose-scheme-StatusImPR.png b/doc/images/how-to-catch-crash-on-ios/choose-scheme-StatusImPR.png
new file mode 100644
index 0000000000..f7f99b4467
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/choose-scheme-StatusImPR.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/config-release.png b/doc/images/how-to-catch-crash-on-ios/config-release.png
new file mode 100644
index 0000000000..355cdeb15b
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/config-release.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/edit-dev.png b/doc/images/how-to-catch-crash-on-ios/edit-dev.png
new file mode 100644
index 0000000000..ee06ba0a89
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/edit-dev.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/edit-scheme.png b/doc/images/how-to-catch-crash-on-ios/edit-scheme.png
new file mode 100644
index 0000000000..8ec6096a4e
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/edit-scheme.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/edit-shadow-cljs.png b/doc/images/how-to-catch-crash-on-ios/edit-shadow-cljs.png
new file mode 100644
index 0000000000..4704d3d395
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/edit-shadow-cljs.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/located-go-code.png b/doc/images/how-to-catch-crash-on-ios/located-go-code.png
new file mode 100644
index 0000000000..b8138ce8f0
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/located-go-code.png differ
diff --git a/doc/images/how-to-catch-crash-on-ios/located-stack-trace.png b/doc/images/how-to-catch-crash-on-ios/located-stack-trace.png
new file mode 100644
index 0000000000..c0b06d15d8
Binary files /dev/null and b/doc/images/how-to-catch-crash-on-ios/located-stack-trace.png differ