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

# Single Node Configuration

<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-docs-evm-account-model/zfxxT2h3qKVo3V2D/images/networks/localnet/single-node-configuration/single-node-configuration-2.png?fit=max&auto=format&n=zfxxT2h3qKVo3V2D&q=85&s=0a8ba0582148f6bcd215138622b6b8fb" 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-docs-evm-account-model/zfxxT2h3qKVo3V2D/images/networks/localnet/single-node-configuration/single-node-configuration-3.png?fit=max&auto=format&n=zfxxT2h3qKVo3V2D&q=85&s=bb58881e116e94f5289f0e5a4efb47e9" 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-docs-evm-account-model/zfxxT2h3qKVo3V2D/images/networks/localnet/single-node-configuration/single-node-configuration-4.png?fit=max&auto=format&n=zfxxT2h3qKVo3V2D&q=85&s=20bc7ce982f3ac150e44b7bf58a3034d" 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/hiero-ledger/hiero-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-docs-evm-account-model/zfxxT2h3qKVo3V2D/images/networks/localnet/single-node-configuration/single-node-configuration-1.png?fit=max&auto=format&n=zfxxT2h3qKVo3V2D&q=85&s=a2f082d8e197947f81f62679d1e2d15c" width="1330" height="2036" data-path="images/networks/localnet/single-node-configuration/single-node-configuration-1.png" />
</Frame>