Welcome to the workshop! 👋
We are going to be getting up and running with homestar, the IPVM reference impelementation. We'll be running workflows locally and seeing how homestar works across the p2p network.
For full documentation on homestar, please see https://docs.everywhere.computer/.
Please ensure you have kubo, the GoLang IPFS node installed:
- Install kubo: https://docs.ipfs.tech/install/command-line/#install-official-binary-distributions (or desktop: https://docs.ipfs.tech/install/ipfs-desktop/)
Make sure kubo is running! Either by launching IPFS Desktop, or running ipfs daemon.
All functions (along with inputs and receipts) are content addressed. We will refer to them by their CID. To add the functions to your local IPFS node, run:
ipfs add --cid-version 1 ./functions.wasmTo install homestar for this workshop, we recommend downloading a build directly from github. (this is still under very active development!)
Install homestar using brew by running:
brew install fission-codes/fission/homestar- Go to this page and scroll down to "Artifacts".
- Download the
.zipfile for your platform - we recommend themuslbuild for linux - Unzip the file and move the
homestarbinary to somewhere in your path (e.g./usr/local/bin) - Make sure the binary is executable (
chmod +x /usr/local/bin/homestar)
Using WSL2 is recommended for this workshop. If you're using Windows, please follow the Linux instructions above.
We'll want to generate a key for your homestar instance. This will be used to identify your node on the network. To do this, run:
openssl ecparam -genkey -name secp256k1 -outform DER -out secp256k1_key.derWe can now start the node by running:
homestar start -c ./settings.tomlVisit https://control.everywhere.computer/. With your Homestar and IPFS node running locally, you can experiment with creating your own workflows and running them locally.
