> ## 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.

# Run a Local Node in Codespaces

> Set up and run a Hedera local node inside a GitHub Codespaces cloud development environment using a Configuration-as-Code devcontainer and VS Code Desktop.

<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>

Codespaces is a cloud development environment (CDE) that's hosted in the cloud. You can customize your project for GitHub Codespaces by committing configuration files to your repository (often known as Configuration-as-Code), which creates a repeatable codespaces configuration for all users of your project. [GitHub Codespaces overview](https://docs.github.com/en/codespaces/overview)

***

## Prerequisites

* Review first the [Quickstart for GitHub Codespaces](https://docs.github.com/en/codespaces/getting-started/quickstart) guide.
* Install VS Code Desktop application.
* In [Editor preference](https://github.com/settings/codespaces) change your client to `Visual Studio Code` (Should not be `Visual Studio Code for the Web`)

***

## Configure Dev Container

To configure t he dev container, open the [Hedela Local Node repo](https://github.com/hashgraph/hedera-local-node) and click on the `Code`->`Codespaces`->`...`-> `Configure dev container`.

<Frame>
  <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/aza5bebLv1xevuM1/images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-1.png?fit=max&auto=format&n=aza5bebLv1xevuM1&q=85&s=bd28aa58293f5d141f398f015ca3b6ed" width="1886" height="1408" data-path="images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-1.png" />
</Frame>

This will open the dev container configuration file where you can customize your configuration like the CPUs and memory.

<Frame>
  <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/aza5bebLv1xevuM1/images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-2.png?fit=max&auto=format&n=aza5bebLv1xevuM1&q=85&s=5b347aa86576181f722ba7852b729224" width="1996" height="814" data-path="images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-2.png" />
</Frame>

<Info>
  **Note**: If you make changes to your config file, commit and push your changes before running local node, to ensure the project starts with the right configuration.
</Info>

## Creating and Running Your Codespace

Open the [Hedela Local Node repo](https://github.com/hashgraph/hedera-local-node) and click on the `Code`->`Codespaces`->`...`-> `New with options...` button and choose the appropriate settings:

<Frame>
  <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/aza5bebLv1xevuM1/images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-3.jpg?fit=max&auto=format&n=aza5bebLv1xevuM1&q=85&s=75795b97a7096668287212333039e79d" width="1111" height="1054" data-path="images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-3.jpg" />
</Frame>

Once your codespace is created, the template repository will be automatically cloned into it. Your codespace is all set up and have the local node running!

<Frame>
  <img src="https://mintcdn.com/hedera-0c6e0218-mintlify-bc559771/aza5bebLv1xevuM1/images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-4.png?fit=max&auto=format&n=aza5bebLv1xevuM1&q=85&s=eca973cded59d478df47e648fc376325" width="1790" height="1086" data-path="images/tutorials/local-node/how-to-run-hedera-local-node-in-a-cloud-development-environment-cde/codespaces/codespaces-4.png" />
</Frame>

***

## Conclusion and Additional Resources

Congrats on successfully setting up your Codespace and running a Hedera Local Node!

**➡** [**Hedera Local Node Repository**](https://github.com/hashgraph/hedera-local-node#readme)

**➡** [**Quickstart for GitHub Codespaces**](https://docs.github.com/en/codespaces/getting-started/quickstart)

**➡** [**Adding Dev Container Config to Repo**](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration)