> ## Documentation Index
> Fetch the complete documentation index at: https://hedera-0c6e0218-mintlify-bc559771.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Single Node Configuration

> Run the Hedera local node in single-node mode for fast local debugging, prototype development, and testing dApps without network latency or shared state.

<Warning>
  **Hiero Local Node Deprecation (September 2026)**
  Hiero Local Node is entering a 6-month deprecation period. Support ends September 2026. Migrate local testing and CI workflows to [Solo](https://solo.hiero.org/docs/) before then. [Learn more](https://hedera.com/blog/hiero-local-node-deprecation-6-month-transition-to-solo/).
</Warning>

## Using Single Node Configuration

Single node configuration simulates the network’s functions on a smaller scale (single node), ideal for debugging, testing, and prototype development.

<Accordion title="Single Node Mode Requirements">
  Ensure the **`VirtioFS`** file sharing implementation is enabled in the docker settings.

  <Frame>
    <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/ziCKGOgsAcuQ9RPD/images/networks/localnet/single-node-configuration/single-node-configuration-2.png?fit=max&auto=format&n=ziCKGOgsAcuQ9RPD&q=85&s=3c2a0dbcbec95ccafbaa8c60ee863e70" alt="" width="2540" height="1440" data-path="images/networks/localnet/single-node-configuration/single-node-configuration-2.png" />
  </Frame>

  Ensure the following configurations are set at minimum in Docker **Settings** -> **Resources** and are available for use:

  **CPUs:** 6

  **Memory:** 8GB

  **Swap:** 1 GB

  **Disk Image Size:** 64 GB

  <Frame>
    <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/ziCKGOgsAcuQ9RPD/images/networks/localnet/single-node-configuration/single-node-configuration-3.png?fit=max&auto=format&n=ziCKGOgsAcuQ9RPD&q=85&s=1a567ed14e3c8231807e11a2585e45e9" alt="" width="1696" height="1144" data-path="images/networks/localnet/single-node-configuration/single-node-configuration-3.png" />
  </Frame>

  Ensure the **`Allow the default Docker sockets to be used (requires password)`** is enabled in Docker **Settings -> Advanced**.

  <Frame>
    <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/ziCKGOgsAcuQ9RPD/images/networks/localnet/single-node-configuration/single-node-configuration-4.png?fit=max&auto=format&n=ziCKGOgsAcuQ9RPD&q=85&s=a0b3108596de0745425bee02ea930648" alt="" width="1352" height="819" data-path="images/networks/localnet/single-node-configuration/single-node-configuration-4.png" />
  </Frame>

  **Note:** The image may look different if you are on a different version
</Accordion>

#### **Starting and Stopping Node**

Before launching the network commands, confirm that Docker is installed and open on your machine. To stop your local node, use the following `npm` or `docker` commands. Before proceeding with this operation, make sure to back up any manually created files in the working directory.

<Accordion title="npm commands">
  ```bash wrap theme={null}
  # npm command to start the local network and generate accounts in detached mode
  npm run start -- -d

  # npm command to stop
  npm run stop

  # npm command to restart node
  npm run restart
  ```
</Accordion>

<Accordion title="docker commands">
  ```bash theme={null}
  # Docker command to start the local network. Does not generate accounts
  docker compose up -d

  # Docker command to stop services
  docker compose stop

  # Docker command to restart local network
  docker compose restart

  # Docker command to stop local network and remove containers
  docker compose down
  ```
</Accordion>

Alternatively, run `docker compose down -v; git clean -xfd; git reset --hard` to stop the local node and reset it to its original state. The full list of available commands can be found [here](https://github.com/hashgraph/hedera-local-node?tab=readme-ov-file#commands).

#### Single Node Mode Diagram

The following diagram illustrates the architecture and flow of data in single node mode.

<Frame>
  <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/ziCKGOgsAcuQ9RPD/images/networks/localnet/single-node-configuration/single-node-configuration-1.png?fit=max&auto=format&n=ziCKGOgsAcuQ9RPD&q=85&s=1946d833dfeba3aed50cad3fd3e3d19e" width="1330" height="2036" data-path="images/networks/localnet/single-node-configuration/single-node-configuration-1.png" />
</Frame>