This repo contains the tooling needed to deploy and operate always-on nodes for Holochain applications (hApps).
The tooling consists of:
- Edge Node - A Docker container specification for running Holochain with hApps in an OCI-compliant containerized environment.
- HolOS - A streamlined Linux ISO that enables the deployment of this container on physical or virtual hardware (especially HoloPorts).
For a detailed overview and usage instructions see here.
- hackmd - How To Set Up Always-On Nodes for Your Holochain Apps
- gdoc - How To Set Up Always-On Nodes for Your Holochain Apps
- Edge Node Support Telegram
- Schedule Live-Support
- Holo Host Forum
A Docker-based container that delivers Edge Node, ready to run hApps:
- Holochain conductor configured to automatically run via
tini. - Tools for installing and managing hApps from configuration files.
A specialized OS builder for creating custom ISO images using Buildroot, featuring:
- Optimized Linux kernel.
- Integrated Holochain services and dependencies (via
runc-deployed Edge Node container). - Custom init scripts for automatic network configuration.
- Generates ready-to-burn disk images for deployment.
- A CLI utility for creating and validating hApp config files.
- Pull the Docker image:
docker pull ghcr.io/holo-host/edgenode- Launch with persistent storage:
docker run --name edgenode -dit -v $(pwd)/holo-data:/data ghcr.io/holo-host/edgenode- Access the container and check for a running hApp-ready
holochainprocess:
docker exec -it edgenode su - nonroot
ps -ef- Download a release of the iso from our releases page: https://github.com/Holo-Host/edgenode/releases/download/v0.0.7ga.5/holos-v0.0.7ga.5.iso
- Burn the iso to a USB stick to install on your own physical hardware or install it in a virtualized environment of your choosing. For a more detailed step-by-step on this, please follow the instructions in the Support How To Guide.
- Choose live-mode or install from the Grub boot menu