Edge Node

This repo contains the tooling needed to deploy and operate always-on nodes for Holochain applications (hApps).

The tooling consists of:

1. Edge Node - A Docker container specification for running Holochain with hApps in an OCI-compliant containerized environment.
2. 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.

For Support

• 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

Repo Components

Container Build System

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.

HolOS Build System

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.

Tools

• A CLI utility for creating and validating hApp config files.

Quick Start

To test the Edge Node container:

1. Pull the Docker image:

docker pull ghcr.io/holo-host/edgenode

2. Launch with persistent storage:

docker run --name edgenode -dit -v $(pwd)/holo-data:/data ghcr.io/holo-host/edgenode

3. Access the container and check for a running hApp-ready holochain process:

docker exec -it edgenode su - nonroot
ps -ef

For HolOS Users

1. 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
2. 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.
3. Choose live-mode or install from the Grub boot menu

Documentation

• Detailed overview and usage instructions
• Edge Node Container Instructions
• HolOS Build System Guide
• Tools for working with Edge Nodes