celestiaorg · jcstein · Nov 28, 2024 · Jun 10, 2024 · Jun 10, 2024 · Jun 17, 2024
diff --git a/.vitepress/config.ts b/.vitepress/config.ts
@@ -456,6 +456,10 @@ function sidebarHome() {
                   text: "Troubleshooting",
                   link: "/nodes/celestia-node-troubleshooting",
                 },
+                {
+                  text: "Datastore structure",
+                  link: "nodes/celestia-node-store-structure",
+                },
-                {
-                  text: "Datastore structure",
-                  link: "nodes/celestia-node-store-structure",
-                },
+                {
+                  text: "Datastore structure",
+                  link: "/how-to-guides/celestia-node-store-structure",
+                },
-                {
-                  text: "Datastore structure",
-                  link: "nodes/celestia-node-store-structure",
-                },
+                {
+                  text: "Datastore structure",
+                  link: "/how-to-guides/celestia-node-store-structure",
+                },
               ],
             },
             {

diff --git a/nodes/celestia-node-store-structure.md b/nodes/celestia-node-store-structure.md
@@ -0,0 +1,28 @@
+---
+description: This section contains information on the celestia-node datastore and its contents.
+---
+
+# celestia-node datastore
+
+The node's datastore refers to the storage structure
+used to manage the data that supports the node's operation.
+It consists of directories and files that contain the node's state,
+configuration, and other information relevant to the node.
+
+The following are the directories and files found in the datastore:
+
+- `/blocks`: This directory stores blocks. Each file contained in this directory
+represents a block on Celestia and contains its associated data. However, the light node's datastore does not contain this directory as light nodes do not store blocks.
+
+- `/data`: This directory contains block headers and various files belonging to node LSM storage system such as `DISCARD`, `KEYREGISTRY`, and`MANIFEST`.
+
+- `/index`: This directory stores the index files that handle mapping specific keys such as block heights, to the corresponding data. Similar to `/blocks`, the light node's datastore does not include this directory as they do not perform indexing.
+
+- `/inverted_index`: This directory stores the inverted index files used for mapping queries to the corresponding data location, and various files belonging to node LSM storage system such as `DISCARD`, `KEYREGISTRY`, `LOCK`, and `MANIFEST`. The light node's datastore does not contain this directory.
+
+- `/keys`: This directory stores the cryptographic key pairs that are used to operate the node.
+
+- `/transients`: This directory contains temporary data such as cache files
+that are used while the node is operating, but are not a part of the permanent blockchain state.
+
+- `config.toml`: This is the node's primary configuration file. It defines the node's core settings such as the network parameters.