---
title: Project Settings
slug: edgemanager/lem-user-ui/product-features/lem-settings/project-settings
description: Projects represent an individual plant that a company operates. 
docTags: 
createdAt: 2022-08-03T17:02:45.000Z
---

A project represents an individual plant that a company operates. Projects contain the edge devices required for plant operations and maintain separate team access privileges from company-level teams.

**Project Settings** provide a centralized location to configure data storage format, backup retention, metrics sync intervals, time zone, team access, MQTT connectivity, and the message schema used by connected devices.

# Why This Matters

Each plant may have different network environments, data requirements, and operational teams. Project-level settings let you configure these independently by plant without affecting other projects in the same company.

# Core Components

Project Settings are organized across four tabs:

| Tab                | Purpose                                                                           |
| ------------------ | --------------------------------------------------------------------------------- |
| **Settings**       | Operational configuration: storage format, backups, metrics, incidents, time zone |
| **Members**        | Team assignment and access privileges for the project                             |
| **Credentials**    | MQTT connection details, SSL certificates, topics, and ACL                        |
| **Message Schema** | JSON schema for messages published by connected devices                           |

# Operational Model

## Backup Retention

LEM retains the most recent backups per edge device. The default retention count is three backups per device.

## Metrics Sync Interval

Configure how frequently LEM polls edge devices for metrics. You can:

- Set a project-specific sync interval (in seconds) in **Enable Edge Device Metrics Sync**.
- Defer to the interval defined in individual edge devices by selecting **Use instance's edge device metrics sync settings**.

# Roles and Permissions

- **Team access**: Assign company-level teams to the project from the **Members** tab. Team definitions are managed in [Company Settings](docId\:XwUuYveHjgIbb0bYwlwSt).
- **MQTT access control**: The **Credentials** tab manages credentials, custom topics, and ACL entries that control which clients can publish to or subscribe from project topics.

# Project Settings

Use the **Settings** tab to configure the project name and description, edge device data storage and backup settings, metrics reporting intervals, incident resolution behavior, and time zone. You can also remove a project from this tab.

## Project

Modify the project name, and add or modify the project description.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/G1RPuCL5D8Z0CAwiM0_CB_image.png" size="80" width="1769" height="228" position="flex-start" caption="Settings: Project" darkWidth="1769" darkHeight="228" showCaption="true"}

## Edge Device Data Storage

You have the option of storing edge device data in ClickHouse. You can store raw data or OMA (Open Mobile Alliance) data.&#x20;

- **OMA data**: OMA data has been deprecated from Litmus Edge and Litmus Edge Manager, but this option is available for backwards compatibility. We recommend selecting **RAW data**.&#x20;
- **RAW data**: We recommend using this option. To visualize data in Grafana, you must select **RAW data**. See [Grafana Dashboards](docId\:YTC1N5pOOjR1elW34jQmF) and [Visualize Child Device Data Using Grafana](docId\:cY2MwkiuvJ2nvNBZhaotC) to learn more.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/N0Phg9B7RCZNh8CgxucSE_image.png" size="100" width="1241" height="223" position="flex-start" caption="Edge Device Data Storage section" indent="2" darkWidth="1241" darkHeight="223" showCaption="true"}

## Edge Devices Backups

Configure the backup retention policy for edge devices. By default, Litmus Edge Manager stores the three latest backups per edge device.&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/H4GGmmo5GvcN3PdsoVxXQ_image.png" size="80" width="1241" height="193" position="flex-start" caption="Edge Devices Backups section" darkWidth="1241" darkHeight="193" showCaption="true"}

## Edge Device Metrics Sync Interval

Edge Device Metrics Sync controls how often Litmus Edge Manager polls connected edge devices for metrics data. Adjusting the interval lets you balance reporting frequency against network and performance constraints. A shorter interval provides more granular visibility into edge device behavior. A longer interval reduces network load in bandwidth-limited environments.

### Sync Interval Priority

The sync interval can be configured at three levels: device, project and instance. By default, lower-level settings take priority:

- The device sync setting overrides the project setting for that device.
- The project sync setting overrides the instance setting for all devices in the project.

You can also override these priority settings:

- At the device level by choosing to use the project's metrics sync settings (see [Manage](docId\:BoOFh2bJOlfpger0QymmF)).
- Here at the project level by enabling **Use instance's edge device metrics sync settings** (see [Management](docId\:VzYNhoUsLtjETO0F1aFa1)).

:::hint{type="info"}
**Note**: **Edge Device Metrics Sync Settings** is available for Litmus Edge Manager version 2.26.1 and later.&#x20;
:::

### Set the Edge Device Metrics Sync Interval

The default interval is 30 seconds with a valid range of `30` to `604,800` seconds (1 week).&#x20;

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/3GY702hq6YEhqoSXWSlyK_image.png" size="80" width="1461" height="278" position="flex-start" darkWidth="1461" darkHeight="278" showCaption="false"}

Do any of the following:

- Use the **Enable Edge Device Metrics Sync** toggle to enable or disable synchronization of metrics.
- Update the sync interval for the project by providing a new value in **Enable Edge Device Metrics Sync**.
- To instead use the interval defined by the instance, select **Use instance's edge device metrics sync settings**.
- Manually trigger a synch by clicking **Fetch Latest Data**.

## Timezone

Select the time zone for your project. You can remove the time zone and reselect the time zone.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/ZKbsTNIpo0XQ_SbnfATBM_image.png" size="80" width="1400" height="150" position="flex-start" caption="Settings: Timezone" darkWidth="1400" darkHeight="150" showCaption="true"}

## Remove Project

Remove the selected project. Removing a project cannot be undone.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/HvG8eoP3hmM4TnPCFnXAU_image.png" size="80" width="1405" height="91" position="flex-start" caption="Settings: Remove Project" darkWidth="1405" darkHeight="91" showCaption="true"}

# Members Tab

## Teams

Select a company-level team, including role, for the selected project. Available options for a company-level team are based on teams you added in the Company Teams section in **Company Settings** > **Company** > **Company Teams** section (see [Company Settings](docId\:XwUuYveHjgIbb0bYwlwSt)).

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/J7mbBgGlMd0IEUsX0klx-_2023-07-2112-40-08.png "Settings: Members tab")

# Credentials Tab

## Connection

Copy any of the server URLs listed in the connection list.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/OnP9A9fOj5OX-AT6PtC3w_image.png" size="80" width="1692" height="263" position="flex-start" caption="Litmus Edge Manager User UI : Settings : Credentials tab : Connection" darkWidth="1692" darkHeight="263" showCaption="true"}

## MQTT Server SSL Certificate

View, copy, or download MQTT server certificate.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/WEtdeC6XeSqsNNuvmBDWk_image.png "Credentials tab: Web Server SSL Certificate")

## Web Server SSL Certificate

View, copy, or download Web server SSL certificate.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/q0F3MZ86xxIyo9N5K9Ixg_image.png "Credentials tab: Web Server SSL Certificate")

## Credentials

Add, copy, or remove a credential. Credentials are used for accessing wildcard and custom topics.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/v_tM4WUGnEJIUB2sDwIHf_image.png" size="80" width="1688" height="233" position="flex-start" caption="Credentials tab: Credentials" darkWidth="1688" darkHeight="233" showCaption="true"}

## Topics

You can add, copy, and remove a custom topic. You can copy a default topic.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/zcetwhCww3HREhZvzQVCF_image.png" size="80" width="1688" height="475" position="flex-start" caption="Credentials tab: Topics" darkWidth="1688" darkHeight="475" showCaption="true"}

There are three preloaded topics credentials:

- To send the data
- To send request
- To receive responses

## ACL

You can add or remove an access control for a topic associated with the selected project.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/14DiUkV__2sMoGZI20QdI_image.png" size="80" width="1686" height="529" position="flex-start" caption="Credentials tab: ACL" darkWidth="1686" darkHeight="529" showCaption="true"}

# Message Schema Tab

From the *JSON&#xA0;*&#x73;ection, you can view and download the JSON schema of messages from devices that publish to the MQTT data topic.

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/9d1ZdvBXhKTBCjiKvtGbC_image.png" size="80" width="1920" height="969" position="flex-start" caption=" Settings: Message Schema " darkWidth="1920" darkHeight="969" showCaption="true"}

# Related Topics

- [Company Settings](#)
- [Management](#)
- [Grafana Dashboards](#)
- [Visualize Child Device Data Using Grafana](#)
- [OMA LightweightM2M (LwM2M) Object and Resource Registry](https://technical.openmobilealliance.org/OMNA/LwM2M/LwM2MRegistry.html)&#x20;
