Document how to run the Linea stack.

docs/developers/guides/community/irys-dynamic-nfts.mdx

@@ -1,6 +1,6 @@
 ---
 title: Create a dynamic NFT
-image: /img/socialCards/build-a-dynamic-nft.jpg
+image: /img/socialCards/create-a-dynamic-nft.jpg
 description: Create NFTs that evolve based on user actions.
 ---
 

docs/developers/guides/community/irys-nfts.md

@@ -1,6 +1,6 @@
 ---
 title: Create an NFT
-image: /img/socialCards/build-a-nft.jpg
+image: /img/socialCards/create-an-nft.jpg
 description: Build permanent NFTs using Irys and Linea.
 ---
 

docs/developers/guides/run-linea/index.mdx

@@ -0,0 +1,34 @@
+---
+description: How to run a Linea network.
+image: /img/socialCards/how-to-run-a-linea-network.jpg
+---
+
+import DocCardList from "@theme/DocCardList";
+
+# Run Linea
+
+You can run the entire Linea stack or a Linea node. Choosing between running the entire Linea stack
+and a Linea node depends on your specific needs and the environment you're working in.
+
+## When to run the Linea stack
+
+:::info
+Currently, the Linea stack is available for local deployments only.
+:::
+
+Run the Linea stack locally if you want to develop or test applications on Linea without connecting
+to Sepolia or Ethereum Mainnet.
+
+The Linea stack incorporates the base layer (L1) and the Linea stack itself.
+By running the entire Linea stack locally, developers benefit from a controlled environment that provides
+direct access to the blockchain's capabilities.
+
+## When to run a Linea node
+
+Run a Linea node if you want a local view of the Linea blockchain state.
+A node enables users to call Linea JSON-RPC API methods and submit transactions to the
+mempool independently, without depending on external RPC providers.
+
+Select the appropriate card for more information on running Linea using your preferred setup:
+
+<DocCardList />

docs/developers/guides/run-linea/run-the-stack/index.mdx

@@ -0,0 +1,30 @@
+---
+description: Run the Linea stack.
+image: /img/socialCards/run-the-linea-stack.jpg
+---
+
+import DocCardList from "@theme/DocCardList";
+
+# Run the Linea stack
+
+:::info
+
+The Linea stack is currently available only for local testing. This includes a local version of the
+base layer (Hyperledger Besu) and the Linea stack itself.
+
+:::
+
+Run the the entire Linea stack to get working versions of:
+
+- **Sequencer**: Responsible for ordering, building, and executing blocks.
+- **State manager**: Manages the L2 network and account states.
+- **Coordinator**: Coordinates the steps to create zk proofs and ensures their persistence on the
+    L1 Ethereum network. It specifically handles batch conflation, blob creation, and aggregation.
+- **Traces API**: Provides trace counts and generates conflated trace files for zk proof creation.
+- **Provers**: Generates three types of zk-SNARK proofs: execution, compression, and aggregation.
+
+Refer to the [Linea architecture documentation](../../../../architecture/index.mdx) for more information
+about the Linea stack components. 
+
+
+<DocCardList />

docs/developers/guides/run-linea/run-the-stack/local.mdx

@@ -0,0 +1,115 @@
+---
+description: Run the Linea stack locally.
+image: /img/socialCards/run-the-linea-stack-locally.jpg
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
+# Run locally
+
+## Prerequisites
+
+Install the following:
+
+- [Node.js v18 or later](https://nodejs.org/en/download/package-manager)
+- [Docker v24 or later](https://docs.docker.com/get-docker/)
+- [Docker Compose v2.19 or later](https://docs.docker.com/compose/install/)
+- [Make v3.81 or later](https://www.npmjs.com/package/make)
+- [Pnpm v9.0.6 or later](https://pnpm.io/installation)
+
+:::important
+These instructions run the Linea stack using Docker containers. Set your Docker resources to
+use at least 10 CPU cores, 8 GB of memory, and 1 GB swap space.
+:::
+
+## Run the Linea stack
+
+### 1. Clone the repository
+
+Clone the Linea repository:
+
+```bash
+git clone https://github.com/Consensys/linea-monorepo.git
+```
+
+### 2. Install the dependencies
+
+Change to the root of the directory and install the project dependencies:
+
+```bash
+cd linea-monorepo
+```
+
+```bash
+pnpm install
+```
+
+### 3. Start the Linea stack
+
+Start the network stack. This will also compile and deploy the required rollup contracts:
+
+```bash
+make fresh-start-all
+```
+
+You now have a local developer instance of the entire Linea network, which includes components such as
+the sequencer, prover, coordinator, and a local L1 settlement layer. You can view these components in
+Docker Desktop.
+
+<div class="center-container">
+  <div class="img-large">
+    <img
+      src="/img/docs/build-on-linea/linea-stack.png"
+      alt="Docker Desktop view of the Linea stack."
+    />
+  </div>
+</div>
+
+## View network details
+
+Access the RPC endpoints from the following local URLs:
+
+<Tabs className="my-tabs">
+  <TabItem value="Linea" label="Linea (L2)" default>
+  - Endpoints:
+      - HTTPS: `http://localhost:8545`
+      - WebSockets: `ws://localhost:8546`
+  - Chain ID: `1337`
+  - [Message service address](../../../../architecture/stack/canonical-msg-service/message-service.mdx): `0xe537D669CA013d86EBeF1D64e40fC74CADC91987`
+  - Deployment account private key: `0x1dd171cec7e2995408b5513004e8207fe88d6820aeff0d82463b3e41df251aae`
+  </TabItem>
+    <TabItem value="Base layer" label="Base layer (L1)">
+    - Endpoints:
+        - HTTPS: `http://localhost:8445`
+        - WebSockets: `ws://localhost:8446`
+    - Chain ID: `31648428`
+    - Linea rollup contract address: `0xCf7Ed3AccA5a467e9e704C703E8D87F634fB0Fc9`
+    - Deployment account private key: `0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80`
+    </TabItem>
+</Tabs>
+
+:::info
+You can [connect your MetaMask wallet](https://support.metamask.io/networks-and-sidechains/managing-networks/how-to-add-a-custom-network-rpc/#adding-a-network-manually)
+to the required chain and [import the deployment account](https://support.metamask.io/managing-my-wallet/accounts-and-addresses/how-to-import-an-account/#importing-using-a-private-key)
+to access the test tokens.
+:::
+
+## Stop the Linea stack
+
+You can stop and start the the Docker containers in Docker Desktop. However, constant stopping and
+starting can lead to network or state issues.
+
+Once stopped, you can clean your environment using the following commands:
+
+:::note
+This will permanently remove all Docker images, containers, volumes, and any data saved in them.
+:::
+
+```bash
+make clean-environment
+```
+```bash
+docker system prune --volumes
+```
+

docs/developers/reference/api/eth-sendrawtransaction.mdx

@@ -1,5 +1,7 @@
 ---
 description: Simulate transaction submission to help prevent failed transactions.
+image: >-
+  /img/socialCards/simulate-transaction-submission-to-help-prevent-failed-transactions.jpg
 ---
 
 import Tabs from '@theme/Tabs';

docs/developers/tooling/data-indexers/covalent.md

@@ -138,4 +138,4 @@ Increment can be used for:
 - [Increment](https://www.covalenthq.com/platform/increment/#/?utm_source=linea&utm_medium=partner-docs) - login via the Covalent Platform
 - [Docs](https://www.covalenthq.com/docs/increment/?utm_source=linea&utm_medium=partner-docs) - 
 learn how to use Increment to build dynamic, custom charts
-- [Data models demo](https://www.covalenthq.com/docs/increment/data-models/model-intro/?utm_source=linea&utm_medium=partner-docs) - build analytics in three clicks
+- [Data models demo](https://www.covalenthq.com/docs/increment/data-models/model-intro/?utm_source=linea&utm_medium=partner-docs) - build analytics in three clicks

docs/developers/tooling/data-indexers/dipdup.md

@@ -1,5 +1,6 @@
 ---
 title: DipDup
+image: /img/socialCards/dipdup.jpg
 ---
 
 [DipDup](https://dipdup.io/) is a Python framework for building smart contract indexers.

docs/developers/tooling/node-providers.md

@@ -17,7 +17,7 @@ image: /img/socialCards/node-providers.jpg
 
 ## Run your own node
 
-- [Set it up yourself](../guides/run-a-node)
+- [Set it up yourself](../guides/run-linea/run-a-node/index.mdx)
 - [One-click deploy with EasyNode](https://app.easy-node.xyz/)
 - [One-click deploy with Mintair](https://mintair.xyz/)
 - [One-click deploy with RapidNode](https://rapidnode.xyz/dashboard)

docs/developers/tooling/oracles/tellor.md

@@ -1,6 +1,9 @@
 ---
 title: Tellor
-description: A versatile oracle protocol that can provide data of any type permissionlessly with crypto-economic liveness and security.
+description: >-
+  A versatile oracle protocol that can provide data of any type permissionlessly
+  with crypto-economic liveness and security.
+image: /img/socialCards/tellor.jpg
 ---
 
 # Tellor

docs/developers/tooling/permanent-data/irys/irys-quickstart.md

@@ -1,6 +1,6 @@
 ---
 title: Irys quickstart
-image: /img/socialCards/quickstart.jpg
+image: /img/socialCards/irys-quickstart.jpg
 description: Creating permanent data using Irys SDK.
 ---
 

docusaurus.config.js

@@ -137,9 +137,9 @@ const config = {
           //   ],
           // },
           {
-            to: "/developers/guides/run-a-node",
+            to: "/developers/guides/run-linea",
             position: "left",
-            label: "Run a node",
+            label: "Run Linea",
           },
           {
             to: "/developers/linea-version",
@@ -381,11 +381,12 @@ const config = {
             from: "/build-on-linea/gas-fees",
           },
           {
-            to: "/developers/guides/run-a-node",
+            to: "/developers/guides/run-linea",
             from: [
               "/build-on-linea/run-a-node",
               "/build-on-linea/run-a-node/use-binary",
               "/build-on-linea/run-a-node/use-docker",
+              "/developers/guides/run-a-node",
             ],
           },
           {

sidebars.js

@@ -162,18 +162,41 @@ const sidebars = {
         },
         "developers/guides/linea-api/index",
         "developers/guides/linea-sdk/index",
+
         {
           type: "category",
-          label: "Run a Linea node",
+          label: "Run Linea",
           link: {
             type: "doc",
-            id: "developers/guides/run-a-node/index",
+            id: "developers/guides/run-linea/index",
           },
           items: [
-            "developers/guides/run-a-node/use-docker",
-            "developers/guides/run-a-node/use-binary",
+            {
+              type: "category",
+              label: "Run the Linea stack",
+              link: {
+                type: "doc",
+                id: "developers/guides/run-linea/run-the-stack/index",
+              },
+              items: [
+                "developers/guides/run-linea/run-the-stack/local",
+              ],
+            },
+            {
+              type: "category",
+              label: "Run a Linea node",
+              link: {
+                type: "doc",
+                id: "developers/guides/run-linea/run-a-node/index",
+              },
+              items: [
+                "developers/guides/run-linea/run-a-node/use-docker",
+                "developers/guides/run-linea/run-a-node/use-binary",
+              ],
+            },
           ],
         },
+
         "developers/guides/linea-safe",
         "developers/guides/linea-inscriptions",
       ],

src/components/HomepageCards/index.tsx

@@ -51,12 +51,13 @@ const CardList: CardItem[] = [
     icon: CardIcon2,
   },
   {
-    title: "Run a node",
-    link: "/developers/guides/run-a-node",
+    title: "Run Linea",
+    link: "/developers/guides/run-linea",
     description: (
       <>
-        Learn how to run a Linea node with Besu or Geth, and interact with the
+        Learn how to run a Linea node or the Linea stack, and interact with the
         blockchain locally
+
       </>
     ),
     buttonName: "Learn",

src/css/custom.css

@@ -571,7 +571,7 @@ html[data-theme="dark"] .header-dockerhub-link::before {
 .navbar__link[href="/users"]::before,
 .navbar__link[href="/developers/quickstart"]::before,
 .navbar__link[href="/architecture"]::before,
-.navbar__link[href="/developers/guides/run-a-node"]::before {
+.navbar__link[href="/developers/guides/run-linea"]::before {
   content: "";
   display: inline-block;
   width: 7px;
@@ -588,7 +588,7 @@ html[data-theme="dark"] .header-dockerhub-link::before {
 .navbar__link[href="/users"]:hover::before,
 .navbar__link[href="/developers/quickstart"]:hover::before,
 .navbar__link[href="/architecture"]:hover::before,
-.navbar__link[href="/developers/guides/run-a-node"]:hover::before {
+.navbar__link[href="/developers/guides/run-linea"]:hover::before {
   background-color: #61dfff;
   border: 1px solid #61dfff;
 }
@@ -610,7 +610,7 @@ html[data-theme="dark"] .header-dockerhub-link::before {
   .navbar__link[href="/users"]::before,
   .navbar__link[href="/developers/quickstart"]::before,
   .navbar__link[href="/architecture"]::before,
-  .navbar__link[href="/developers/guides/run-a-node"]::before {
+  .navbar__link[href="/developers/guides/run-linea"]::before {
     display: none;
   }
 }