A GUI for Substrate / Polkadot Zombienet application
- Install the required Provider so that network orchestrated by Larch and Zombienet
- Podman -> v3.x / v4.x,
- On Mac OS please generate your own Polkadot / Parachain images native to mac os (No official Mac specific images from Parity) and specify image name and tag in templates as required.
- If want to run x86_64 images on Mac OS with M1 or higher, try this approach -> Running x86_64-based containers on Mac computers with an Apple silicon (M1) processor
- K8 -> Last tested on k8 v1.27.3 (using Minikube), since Larch depends on the Zombienet, the prerequisites can be referenced from here: GitHub - paritytech/zombienet: A cli tool to easily spawn ephemeral Polkadot/Substrate networks and perform tests against them.
- Podman -> v3.x / v4.x,
- If running the from source, NodeJS v18 or higher is required
-
Execute following commands to start Larch from source
npm i
npm run build
npm run start
-
Execute following commands to start Larch from executable (download from releases)
./larch
-
Application will be started on Port 9000 (Default), to view UI then go the browser and navigate to
http://localhost:9000
. -
Create the network template and then launch the network using the created template.
-
Zombienet will be downloaded by Larch if the supported version binary is not present in the
~/.larch/bin
, once downloaded it will start creating the network
npm run start -- --help
or./larch --help
Welcome to Larch
Usage: larch [options]
GUI Application for managing Zombienet
Options:
-V, --version output the version number
--disable-ui Disable Frontend
--disable-api Disable Backend
--service-port <port> Larch service HTTP listen port (default: "9000")
-h, --help display help for command
- Larch application source is licensed under GNU GPLv3 license