The System app is the bundled app used to manage the Flow Director instance. You cannot delete it.
The default user for this app is
admin with password
changeme. Please change it.
All methods to install apps are in the menu of the New App tile:
Create a new App
This displays a dialog where you define a unique name (no space or special characters), a title, and an icon:
CREATE and the app is created.
Import existing App
You can import an app that has been previously exported somewhere here:
Just drop the exported app file into the drop zone. There are 2 import strategies possible, merge and replace. Both are only relevant if the app already exists. Merge adds new files and updates existing files. Replace fully replaces the app with the imported app.
Install App from Git
Apps that have been linked and pushed to a Git repository can be installed from that repository here:
Enter the Git URL, the branch, and username/password to access the repository. If you use a personal access token, check the documentation of the Git provider where you need to put that token. For GitHub, it is in the username field by leaving the password field unset. GitLab uses the password field for the token, and the username field unset. Bitbucket has a special URL for the token.
To move an app to a Git repository, you need:
Create an empty Git repository and add a
Create an app as described in Create new App.
Log in to the app.
Use the Git button to link it to that Git repository.
Commit and push.
Install App from App Library
Flow Director comes with a pre-installed app library with the name Flow Director:
Click on it to see the content of this library:
You can use the tags to filter the display. Click the Install checkbox to select the apps. Some might require a license when you log in to the app. Click
to install the selected apps.
You can add your own app libraries if you click the
ADD button of the app library selector. Have a look into the Git Integration section of this documentation.
If you click on an app tile, you can edit the app by changing the title and/or icon:
Exporting an app is only possible for apps that you have created yourself. It is not possible for apps that you have installed from Git or an app library:
Export, an archive is created and automatically downloaded. The archive has the extension
.app. You can use it to import it into another Flow Director instance or to create a backup.
To delete an app, click the tile of the app and choose
Delete from the menu. The app, including all data, is then deleted from this Flow Director instance. If you delete a licensed app from the Flow Director app library, the license is released and used for another licensed app.
Usually, apps produce data streams that you can display in dashboards. These data streams are private to the respective apps. To allow that other apps can access these streams, you can assign grants between apps:
In this example, My First App is granted access to streams of IoT Cloud Azure.
Multi App Login / Single App Login
A Flow Director instance can have installed many apps. The user selects the app he wants to log in in the Login screen:
This is called Multi App Login and default.
But sometimes, you may not want that user to see which apps are installed at the Flow Director instance, i.e., on a public shared Flow Director instance. In that case, you switch to Single App Login mode:
The app selector then looks like this:
To log into the app you want, you specify it in the URL:
It then shows only shows this app in the app selector:
Automatic / Manual Upgrade of Flow Director
A Flow Director installation can upgrade itself to the latest release. You can do it automatically and manually. Click on
to see the preferences:
The above is the default. It checks every night at 2 AM whether a new release is available and upgrades, if necessary.
If you don’t want an automatic upgrade, switch it to manual:
When a new release is available, it is displayed in the headline, and you can perform it manually:
In either way, Flow Director downloads the new release, shuts it down, performs the upgrade, and restarts. Clients connected to Flow Director will automatically reconnect.
To change the password of the System app, click here:
This should be at least done once to have a different password than the default password