From 83c1b73f918565152be19f2d240e5b3993401c1f Mon Sep 17 00:00:00 2001
From: RJ030 <127305878+RJ030@users.noreply.github.com>
Date: Fri, 22 Dec 2023 10:11:14 +0100
Subject: [PATCH] Add documentation about the usage of the --storage-directory
 flag. (#31172)

---
 docs/guides/chip_tool_guide.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/docs/guides/chip_tool_guide.md b/docs/guides/chip_tool_guide.md
index 32ce669d538a68..31aa29353c91ab 100644
--- a/docs/guides/chip_tool_guide.md
+++ b/docs/guides/chip_tool_guide.md
@@ -18,6 +18,10 @@ directory.
 > `/tmp/chip_tool_config.ini` file. Deleting this and other `.ini` files in the
 > `/tmp` directory can sometimes resolve issues related to stale configuration.
 
+> **Note:** To make the configuration persistent (since `/tmp` directory might
+> be flushed at each reboot) you can change the directory where CHIP Tool caches
+> its configuration by using the option `--storage-directory`
+
 <hr>
 
 ## Building and running the CHIP Tool
@@ -676,6 +680,30 @@ The following flags are available:
 
 <hr>
 
+##### Changing storage directory
+
+By default, CHIP Tool stores its configuration into the `/tmp` directory. You
+can change the storage directory by using the `--storage-directory` flag.
+
+Usage:
+
+```
+--storage-directory <directory>
+```
+
+Here, _<directory\>_ is the path to the directory where the configuration is
+stored.
+
+**Example of usage:**
+
+```
+$ ./chip-tool pairing ble-wifi <node_id> <ssid> <password> <pin_code> <discriminator> --storage-directory <directory>
+$ ./chip-tool temperaturemeasurement read measured-value <node_id> <endpoint_id> --storage-directory <directory>
+
+```
+
+<hr>
+
 ### Commissioner name and ID flags
 
 All CHIP Tool commands can be used together with the following