This repo contains the tooling needed to deploy and operate always-on nodes for Holochain applications (hApps).
The tooling consists of:
Edge Node - Docker container specifications for running Holochain with hApps in an OCI-compliant containerized environment. Two variants: edgenode (standard, with log-sender) and edgenode-harvester (with log-harvester for Unyt invoice aggregation).
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 managed by s6-overlay, starting automatically on container launch.
- Tools for installing and managing hApps from configuration files.
- Two variants: standard (
edgenode) and harvester (edgenode-harvester).
- A CLI utility for creating and validating hApp config files.
- Pull the 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- Pull the image:
docker pull ghcr.io/holo-host/edgenode-harvester- Launch with your log-collector credentials:
docker run --name harvester -dit \
-v $(pwd)/holo-data:/data \
-p 4444:4444 \
-p 4445:4445 \
-e COLLECTOR_URL=https://your-log-collector.unyt.dev \
-e ADMIN_SECRET=your-admin-secret \
-e LAIR_PASSWORD=your-lair-password \
ghcr.io/holo-host/edgenode-harvesterSee docker/LOG_HARVESTER_QUICKSTART.md for full setup instructions.