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

# Single Node Configuration

## 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-dependabot-github-actions-actions-setup-nod/FVrTyFA0YFTZGLns/images/networks/localnet/single-node-configuration/single-node-configuration-2.png?fit=max&auto=format&n=FVrTyFA0YFTZGLns&q=85&s=5867a664b8d131265865e6b4f57d351b" 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-dependabot-github-actions-actions-setup-nod/FVrTyFA0YFTZGLns/images/networks/localnet/single-node-configuration/single-node-configuration-3.png?fit=max&auto=format&n=FVrTyFA0YFTZGLns&q=85&s=acd1c8e8ac06cfd98ae30380f24be464" 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-dependabot-github-actions-actions-setup-nod/FVrTyFA0YFTZGLns/images/networks/localnet/single-node-configuration/single-node-configuration-4.png?fit=max&auto=format&n=FVrTyFA0YFTZGLns&q=85&s=a22f4658712841ec9a7a7d062c4660dc" 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-dependabot-github-actions-actions-setup-nod/FVrTyFA0YFTZGLns/images/networks/localnet/single-node-configuration/single-node-configuration-1.png?fit=max&auto=format&n=FVrTyFA0YFTZGLns&q=85&s=5b86b94d71b76655fba642ecd623106c" width="1330" height="2036" data-path="images/networks/localnet/single-node-configuration/single-node-configuration-1.png" />
</Frame>
