# Updating an App in FLECS Core

## Prerequisites

Before installing an app, ensure your device has an **active license**.

**🔍 How to check:**

1. In the sidebar, navigate to **System**.
2. Verify that your device is **activated**.
3. If not, [activate your device license](https://docs.flecs.tech/product-docs/flecs-core/license-activation).

## **Access the Marketplace**

* From the sidebar, select **Marketplace**.
* You can now browse, search, and update your apps.

## Find the App to Update

Use the **search and filter options** for a targeted search.

### **Filter Options:**

* **🔍 Search by Name**: Enter the app’s name.
* **✅ Availability Filter**: Enable **Show Available Apps Only**.
* **📂 Category Filter**: Select a specific category.
* **⚙️ Advanced Filters**: Click the **Filter** button for additional options.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FRgxfGJ6endt30DKAN6st%2Fgrafik.png?alt=media&#x26;token=63238fd8-58bd-4080-a8de-70a4364f3466" alt=""><figcaption><p>Filter the Marketplace Apps</p></figcaption></figure>

**ℹ️ Tip:**\
Apps with updates available are marked with an **exclamation mark (!) in a star icon**.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FsGFxHWyDRPVBNKh7kf6w%2Fgrafik.png?alt=media&#x26;token=10440b3c-b5a5-45e4-af10-f58b734e11fc" alt=""><figcaption><p>Update available for app</p></figcaption></figure>

## Update Process

1. Locate your app in the Marketplace.
2. Click on the app to open the details.
3. Choose the **version** you want to update to.
4. Click **Update** to start the installation.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2F9C3MG9JoQKJ8hnCR6XRe%2Fgrafik.png?alt=media&#x26;token=44119c12-7444-4a9b-a9e0-2cc290228490" alt=""><figcaption><p>Update your app</p></figcaption></figure>

**✅ Automatic Update:**

* FLECS updates the app automatically, preserving all existing **data, settings, and configurations**.
* The process runs in the **background, y**ou may close the window.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FAknoMQmtO61MotZLNJwc%2Fgrafik.png?alt=media&#x26;token=e22c3690-0e0d-416a-97e1-47058370999c" alt=""><figcaption><p>Updating an app</p></figcaption></figure>

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2F6EfL34i3m5aeVPVC7Uk0%2Fgrafik.png?alt=media&#x26;token=785ccccd-4173-41c0-89ea-a95f7031aafe" alt=""><figcaption><p>App update successful</p></figcaption></figure>

## Monitor Update Progress

* Open the **Installation Status** section to track the update progress
* **Progress Tracking:** Monitor the update under 'Installation Status'.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FwTths46TEZphNJc7EpGh%2Fgrafik.png?alt=media&#x26;token=04758c9e-44c9-4455-9c80-1423f83355d5" alt=""><figcaption><p>Show update Log</p></figcaption></figure>

## Using Your Updated App

After the update completes:

1. Navigate to **Apps** in the sidebar.
2. FLECS automatically creates a **new app instance** with the latest version, including all previous configurations and data.

## Managing Versions

* **✅ Successful Update:**\
  If everything works as expected, you can remove the older app version.
* **🔙 Revert if Needed:**\
  If you encounter issues:
  1. **Stop the new instance**.
  2. Select **Start new instance** on the previous version to roll back.

<figure><img src="https://2078425678-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNrNvjiw8yJDuaBQ3eLv5%2Fuploads%2FuDM9bisLI0Ql696W95CN%2Fgrafik.png?alt=media&#x26;token=6f5b3c9e-f8a8-4353-8e5b-98cc14e5b5e0" alt=""><figcaption><p>Apps view after update of the app</p></figcaption></figure>

## Troubleshooting

For any assistance or troubleshooting during the installation process, [contact us](https://flecs.tech/ressources/contact/) anytime.
