# Eliona Marketplace - install and configure apps

The *Eliona* Marketplace is the central point of contact for extending the platform functionalities through apps. This documentation explains the essential steps for using the Marketplace, from app installation to configuration and debugging.

***

## What is the *Eliona* Marketplace?

The *Eliona* Marketplace contains official apps provided or verified by Eliona. These apps enable:

* Integration of expert systems
* Automatic asset creation
* Two-way data and alarm synchronization
* Extensions such as SSO, escalations, notifications, and much more.

***

## Fundamentals of *Eliona*apps

The *Eliona*apps are based on a **microservice architecture**, in which each app is operated as an independent container. This architecture enables a modular, scalable, and fault-tolerant system environment – both when integrating new functions and in daily operation.

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/NVJbbNBrxfDL66yczqO3/image.png" alt=""><figcaption></figcaption></figure>

### Characteristics of the microservice architecture

* **Modularity**\
  → Each app can be deployed and maintained independently
* **Fault tolerance**\
  → Errors in one app do not affect other apps or the system
* **Scalability**\
  → Multiple app instances possible; ideal for large or distributed systems

***

### Implementation by Eliona or customers

Apps can:&#x20;

* be *Eliona*developed and provided by the team
* be implemented independently by customers using the *Eliona App SDK* be implemented&#x20;

### Role of apps in *Eliona*

Apps make it possible to connect *Eliona* to other systems – for example with building technology, sensors, or specialized applications such as access or energy management systems. This connection ensures that data is automatically exchanged between the systems – in both directions. This keeps information in *Eliona* and in the connected system always up to date.

A major advantage: once an app is set up, it automatically detects new devices or objects and creates them directly in *Eliona* as so-called assets – entirely without manual intervention. Alarms from external systems can also be integrated via apps. These are displayed in *Eliona* , can be acknowledged there, and further processed.

In addition to data transmission, many apps offer extra functions, for example:

* **Sign-in with existing user accounts (SSO)**
* **Notifications and escalations via email, chat, or SMS**
* **Booking of resources such as rooms or workspaces**

This makes apps *Eliona* the central platform for the digital operation of buildings – connected, automated, and flexibly expandable.

***

### Comparison of connection options in *Eliona*

*Eliona* offers various ways to connect external systems – depending on complexity, goal, and technical requirements. The most important options are **Apps**, **Connectors** and the **Script Engine**.

#### Apps

Apps offer the most comprehensive integration. They connect *Eliona* not only with other systems, but also automatically create matching assets and keep them synchronized. They enable deep integrations – including alarm processing, user login, or booking functions. Many apps are already available in the *Eliona* Marketplace and can be installed and configured with little effort. However, the development of new apps requires time and technical know-how.

**Advantages:**\
– Comprehensive, stable connection\
– Automatic asset creation\
– Additional functions such as SSO, escalations, or dashboards

**Please note:**\
– The development of new apps is more complex and is usually carried out by Eliona or trained partners

#### Connectors

Connectors are universal interfaces (e.g. MQTT, Webhook, RESTful, Kafka, OPC UA) that are specifically intended for data exchange. They must be set up individually and implemented technically. They transfer data, but do not offer additional functions or automatic asset creation.

**Advantages:**\
– Flexible and quick to use for new systems\
– Supports many common protocols

**Please note:**\
– Configuration and processing must be implemented manually\
– No automatic synchronization or logic included

#### Script Engine

The Script Engine allows simple integrations via SQL or Python scripts. This makes it possible to retrieve, process, or forward data from other sources. It is especially suitable for lightweight, individual adaptations.

**Advantages:**\
– Quick implementation of simple integrations\
– Direct access to data and logic

**Please note:**\
– Limited for complex requirements\
– Maintenance and upkeep are the responsibility of the user

#### Common feature

Regardless of the chosen approach, all connections can be developed and operated both by the *Eliona*team as well as by customers or partners themselves – depending on technical competence and project requirements.

***

### Examples of *Eliona*apps

*Eliona* offers a wide variety of apps that enable specific functions or integrations. These apps can be installed via the *Marketplace* and take on central tasks in integration, visualization, and automation within the platform.

#### Integrations into building management systems (BMS)

Apps for connecting existing building management systems enable seamless integration and central control:

* *Niagara Framework*
* *ABB Building Edge (OpenBOS)*

#### Booking systems

For the management and booking of rooms or resources:

* *Microsoft Exchange*

#### Single Sign-On (SSO)

For central login with existing user accounts:

* *SAML*based systems such as *Microsoft Azure*

#### Expert systems

These apps connect *Eliona* with specialized systems and IoT platforms:

* *MyStrom*, *Thingdust*, *Glutz*, *Signify*
* *Xovis* (People Counter), *Kontakt.io*, *Kentix*, *Zevvy*
* *ABB free\@home*, *Loriot.io*, *Roomz*, *GP Joule*, *V-Zug*
* *Hailo*, *CoffeeCloud*

#### Location monitoring

Apps for locating and tracking the movement of people or objects:

* *Localino*
* *Kontakt.io*

#### Escalation and notification systems

For forwarding alarms and notifications to external channels:

* *SMS*, *Google Chat*, *Slack*

#### Advanced analysis and automation apps

These apps complement *Eliona* with AI-supported or correlation-based functions:

* **Correlation App** – Detects relationships and interactions between system data
* **Forecast App** – Uses historical data to predict future values
* **Reinforcement Learning App** – Optimizes processes through self-learning algorithms based on feedback

***

### Example of an app: *myStrom*

The *myStrom App* is a typical example of a simple but fully integrated *Eliona*app. It shows how an external device – in this case a smart plug – can be connected to *Eliona* .

<figure><img src="https://content.gitbook.com/content/Nyvwhz1kEMXcHf4HLuZ8/blobs/6gm26xjakMP7GnfpQV4p/image.png" alt=""><figcaption></figcaption></figure>

The connection works as follows:

1. The *myStrom*The plug sends its data (e.g. energy consumption, switching status) over the internet.
2. The *myStrom App* in *Eliona* receives this data via an interface and processes it further.
3. Within *Eliona* matching *Assets* are automatically created that visualize the data and enable actions.
4. The user can monitor the plug from *Eliona* or even switch it – depending on the configuration.

This app is lightweight, uses simple REST API communication, and exemplifies how the integration of external IoT devices into *Eliona* can be implemented – without elaborate manual steps.
