# Using your App with FLECS Core

## Navigating to Your App

1. **Access 'Apps':** Begin by navigating to the 'Apps' section in FLECS Core.

## **Minimized View**

* Hover over items for explanations.
* View key details in a glance:
  * **App Name:** e.g., Node-RED.
  * **App Vendor:** e.g., OpenJS Foundation.
  * **App Version:** e.g., 3.0.2.
* Perform quick actions:
  * **Open App:** Launch in a new tab (editor or configurator).
  * **New Instance:** Create, if multi-instance is supported.
  * **Uninstall:** Remove the app.
  * **More Info:** Access additional information and relevant links.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FfKRW60aUOEZOYeHIBJrf%2Fgrafik.png?alt=media&#x26;token=9ee1d4ff-e840-49a9-8ee6-d299a714b2e0" alt=""><figcaption><p>App minimized view</p></figcaption></figure>

## Expanded View for Detailed Control

Expand your app's section for comprehensive control and information.

### General Information

* Hover over items for explanations.
* **App Name:** e.g., Node-RED.
* **App Vendor:** e.g., OpenJS Foundation.
* **App Version:** e.g., 3.0.2.
* **Status Indicators:**
  * **Green:** Running.
  * **Red:** Stopped.
  * **Yellow:** Issue Detected.
* **Instance Details:**
  * **Name**
  * **Version**

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2F7LUNHyTZzX5dsOs3BvKP%2Fgrafik.png?alt=media&#x26;token=c3e82e5e-d0c3-4e82-a1f2-320054a14a42" alt=""><figcaption><p>App maximized view</p></figcaption></figure>

### Actions and Settings

* **Open App:** Launch in a new tab (editor or configurator).
* **New Instance:** Available for multi-instance apps.
* **Uninstall App:** Remove the app completely.
* **Instance Control:**
  * **Start/Stop:** Manage the app instance.
  * **Settings:** Customize instance configurations.
* **Instance Info:** Access details about Ports, Volumes, Logfile.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FNALnR2HWdxzNt4hEYJGb%2Fgrafik.png?alt=media&#x26;token=b1ae261d-c999-4595-bc71-eaee01f8670e" alt=""><figcaption><p>Info about app</p></figcaption></figure>

### Settings for Network or Device Access, Environments and Port Mappings

#### **Network Access**

* Enable app access to network interfaces (Layer 2 Ethernet).
* Necessary for fieldbus protocols (EtherCAT, PROFINET).

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2F27AkmR2pXIErxOJOdq47%2Fgrafik.png?alt=media&#x26;token=ed9877ab-983d-4c8a-97b1-7567e9d6e9f3" alt=""><figcaption><p>Network and Device settings for an app instance</p></figcaption></figure>

#### **USB Devices**

* Grant access to USB devices, CAN interfaces, etc.
* Common for license dongle access.
* Note: Restart the instance after activating USB devices for recognition.

#### **Environment Variables:**

* Set, edit, or delete environment variables for your app instances.
  * Click 'ADD Environment variable'.
  * Add the Key and Value (e.g., `Key=MyEnv Value=123`).
  * Do not use quotation marks.
  * Save your environment settings before closing.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FI2kFEoXcSXh6qaC9ikQp%2Fgrafik.png?alt=media&#x26;token=bf698654-488a-4759-87f4-1cd9b2905159" alt=""><figcaption><p>Set environment variables for your App</p></figcaption></figure>

#### Port Mappings

* Here you can add port mappings to the instance of this app.
  * Click 'ADD PORT MAPPING'
  * Use host:container (e.g., 8081:80 to map the container port 80 to the port 8081 on the host). Do not use quotation marks.
  * Click 'ADD PORT RANGE MAPPING' to select a whole range of ports from Start to End
  * After changing the port mapping, you have to restart the instance in order to apply it.\ <br>

    <figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FHEXCBvcRR3n1H9eJsHe8%2Fgrafik.png?alt=media&#x26;token=25b79482-a5f9-4c35-856f-62f5411f4ca4" alt=""><figcaption><p>Set port mappings for your App instance</p></figcaption></figure>
* **Automatic Scanning:** FLECS scans and displays all network interfaces and devices.
* **Save Configurations:** Remember to save settings before exiting.

#### Editor Hostname and Path Prefix

Here you can define a custom path prefix for the editor of this app instance.

1. **Select the Path Prefix** you want to use.
2. **Enter your desired name** to create a clear and readable URL.
3. **Save your settings** to apply the changes.

After configuration, you can access the editor either via the fixed default URL or your custom URL based on the chosen path prefix.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2F6bwSU21x6OIP5IH3DZBB%2Fgrafik.png?alt=media&#x26;token=d489a3c2-6719-4f98-8894-09c0814f0ca6" alt=""><figcaption><p>Set the Editor hostname for your App instance</p></figcaption></figure>

### Uninstalling an Instance

* **Uninstall Instance:** Remove a specific instance of the app.