https://github.com/hardillb/ff-device-balena

Deploy FlowFuse Device Agent with Balena
https://github.com/hardillb/ff-device-balena

Last synced: about 2 months ago
JSON representation

Deploy FlowFuse Device Agent with Balena

• Host: GitHub
• URL: https://github.com/hardillb/ff-device-balena
• Owner: hardillb
• Created: 2023-11-16T11:00:19.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2023-11-19T21:11:39.000Z (about 1 year ago)
• Last Synced: 2024-10-13T16:11:36.940Z (3 months ago)
• Language: Shell
• Size: 27.3 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Deploy Flowfuse Device Agent with Balena

[![balena deploy button](https://www.balena.io/deploy.svg)](https://dashboard.balena-cloud.com/deploy?repoUrl=https://github.com/hardillb/ff-device-balena)

The documentation for the FlowFuse Device Agent can be found [here](https://flowfuse.com/docs/device-agent/introduction/)

## Configure

The FlowFuse Device Agent can be configured in 3 ways:

 1. If started with no configuration file the Device Agent will start a Web Server that will allow a `device.yml` file to be uploaded locally to the Device. The `device.yml` is provided by the FlowFuse platform when the device is created.

 2. A `device.yml` file provided when the Device is created in the FlowFuse platform. This file can be injected into the Belena devcie using the `FF_DEVICE_YML` environment variable (see below)

 3. A group of Devices can be give a `device.yml` that contains a Provisionig Token. This will cause the Device to connect to the FlowFuse platform and register a new device, it will then download it's own unique `device.yml` file. The Provisioning token can be passed to the Belena device using the `FF_DEVICE_YML` environment variable (see below). Provisioning tokens are created on the Team -> Settings page, under the Device's tab.

    When using a Provisioning Token the Belena Device name will match the FlowFuse Device name.

### Passing configuration via Environment variable

Download either a Device configuration file or a Provisioning token and then Base64 encode this (with no line breaks) using the following command:

```

base64 -w 0 device.yml

```

In the Balena Fleet config set a Variable called `FF_DEVICE_YML` to the output of the base64 command.