Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
103 lines (61 sloc) 3.82 KB

Start an edge node

Typically, an FogFlow edge node needs to deploy a Worker and an IoT broker. The Edge IoT Broker at the edge node can establish the data flows between all task instances launched on the same edge node. However, this Edge IoT Broker is optional, especially when the edge node is a very constrained device that can only support a few tasks without any data dependency.

Here are the steps to start an FogFlow edge node:

Install Docker Engine

To install Docker CE and Docker Compose, please refer to Install Docker CE and Docker Compose on Respberry Pi.


Docker engine must be installed on each edge node, because all task instances in FogFlow will be launched within a docker container.

Download the deployment script

#download the deployment scripts

#make them executable
chmod +x

Download the default configuration file

#download the configuration file

Change the configuration file accordingly

You can use the default setting for a simple test, but you need to change the following addresses according to your own environment:

  • coreservice_ip: please refer to the configuration of the cloud part. This is the accessible address of your FogFlow core services running in the cloud node;
  • external_hostip: this is the external IP address, accessible for the cloud broker. It is useful when your edge node is behind NAT;
  • internal_hostip is the IP of your default docker bridge, which is the "docker0" network interface on your host.
  • site_id is the user-defined ID for the edge Node. Broker and Worker IDs on that node will be formed according to this Site ID.
  • container_autoremove is used to configure that the container associated with a task will be removed once its processing is complete.
  • start_actual_task configures the Fogflow worker to include all those activities that are required to start or terminate a task or maintain a running task along with task configurations instead of performing the minimal effort. It is recommended to keep it true.
  • capacity is the maximum number of docker containers that the FogFlow node can invoke. The user can set the limit by considering resource availability on a node.
//you can see the following part in the default configuration file
    "coreservice_ip": "",
    "external_hostip": "",
    "internal_hostip": "",

    "site_id": "002",

    "worker": {
    "container_autoremove": false,
    "start_actual_task": true,
    "capacity": 4


Start both Edge IoT Broker and FogFlow Worker


if the edge node is ARM-basd, please attach arm as the command parameter

#start both components in the same script

#if the edge node is ARM-basd, please attach arm as the command parameter
#./  arm

Stop both Edge IoT Broker and FogFlow Worker

#stop both components in the same script
You can’t perform that action at this time.