You need to setup an additional edge device as a bootstrap node if mDNS is disabled on your devices or network, or if you are running ActyxOS on Docker.
Instead of automatically finding other nodes via mDNS, your node will now first connect to the bootstrap node, get a list of all nodes in your swarm from the bootstrap node, and then connect to them.
We advise to always use bootstrap nodes in production deployments to make sure all your nodes connect to each other.
Any physical or virtual edge device in your local network can serve as a bootstrap node.
The ActyxOS bootstrap node is publicly available on Docker Hub. You can download and run an ActyxOS bootstrap node with the following command:
Run the bootstrap node with a persistent volume
It is highly recommended to use a persistent volume, as you will otherwise have to change the settings of all your ActyxOS nodes in this swarm each time you start the bootstrap node. If you want the node's identity to be preserved between runs, you need add a persistent volume with
-v for storage of the node's identity. If you do so, the
SWARM_KEY environment variable will be ignored in subsequent runs.
Now that your bootstrap node is running, you can configure nodes in your swarm with it:
- Actyx CLI
- Node Manager
The swarm key is a node setting. You can use the output from above and
ax settings set to configure it:
The swarm key is a node setting. Copy the bootstrap node address from the output above, go to the settings tab change the bootstrap node property and press save: