Get Started Developing with Holochain

Hardware Requirements

Install the Holochain Dev Environment

Prerequisite for Windows: WSL2

The Nix package manager, which we use to install and manage Holochain development tools, only supports Mac and Linux. Please install Linux under Windows with WSL2 (Windows Subsystem for Linux).

Holochain is supported for the Ubuntu distribution under WSL2.

Install the Nix Package Manager and set up Holochain binary cache

At a command line:

bash <(curl https://holochain.github.io/holochain/setup.sh)

Verify installation

In a new shell session, type:

nix develop github:holochain/holochain -c $SHELL -c "holochain --version"

If you see

Holochain development shell spawned. Type exit to leave.
holochain

the Holochain Dev Environment is set up successfully.

Scaffold An Example Holochain App

Type the following at the command line:

nix run github:holochain/holochain#hc-scaffold -- example forum

When prompted, select the UI framework you prefer.

After completing the project setup, the scaffolding tool will output the commands to run the Holochain app.

Next Step

Explore project structure —>

Learn More

  1. Dive into the Holochain Core Concepts.
  2. Take a look at the developer documentation.
  3. Join the discussion in the HC.dev discord.
It looks like you are using Internet Explorer. While the basic content is available, this is no longer a supported browser by the manufacturer, and no attention is being given to having IE work well here.