Skip to content

Cookie preferences

We use cookies for our own analytics, to see how our campaigns perform and, if you allow it, to load content from other services such as the Google site search. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details and our Privacy Policy for how we handle personal data.

Security, load balancing and remembering your cookie choice.

Show us which pages people read, how they find the site and where they get stuck, so we can improve it (Google Analytics, Microsoft Clarity).

Show us which of our ad campaigns bring visitors to the site and remember the campaign or partner link you arrived from (Google Ads, LinkedIn, Meta, partner program). We do not use these cookies to build advertising profiles.

Load the site search from Google when you use it. Google sets its own cookies and shows ads in the search results.
© 2026 The ThingsBoard Authors
22.6k Try for free Menu

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

North America Data stored in North America Europe Data stored in the European Union

Rather run it yourself? Install on your own servers

Settings

The Settings page gives you control over system-level configuration, AI integrations, and white labeling. Navigate to it by clicking the Settings button in the bottom-left corner of the screen.

Settings button in the bottom-left corner of the Trendz UI

System

Section titled “System”

Import / Export

Section titled “Import / Export”

Use the built-in Import/Export mechanism to migrate configuration from one Trendz instance to another.

The following items can be exported and imported:

Group Items
Topology Business entities and their fields, external data sources
Views Views and view collections
Calculations Calculation fields and metric definitions
Anomaly detection Anomaly models and anomalies
Prediction Prediction models, event rules, and targets
AI assistant Chats, chat messages, and prompts
Tasks Tasks and task sequences

Exporting

  1. Click Export.
  2. The browser saves the configuration as a trendz_config_<version>.trendz file on your computer.
System tab of Settings with the Export link highlighted Browser downloads panel with the trendz_config .trendz file highlighted

Importing

  1. Click Import.
  2. Select the .trendz file and click Open.
System tab of Settings with the Import link highlighted File dialog with the trendz_config .trendz file and the Open button highlighted
  1. Check what will be imported. The preview shows the version and date of the file, and for each group the number of new items and the total number of items in the file.
  2. Click Import configuration.
  3. When the import finishes, Trendz shows Import finish successful and the number of imported items in each group.
Import preview with the file version, export date, and New and Total counts per group highlighted Import preview with the Import configuration button highlighted Import finish successful message with Imported and Total counts per group highlighted

When you import from the Settings page, only new items are imported. An item that already exists in Trendz is skipped and keeps its current configuration.

Cache Management

Section titled “Cache Management”

Manage cache layers used by Trendz — such as clearing local or telemetry cache. See the Cache Settings documentation for details.

External Data Source

Section titled “External Data Source”

Configure and manage external SQL data sources and integrate them with Trendz views. See the external datasource guide for details.

AI Settings

Section titled “AI Settings”

Connect AI models and choose which one each AI feature uses:

See AI Settings to learn how to add an AI model and choose which features use it.

White Labeling

Section titled “White Labeling”

Customize the Trendz UI — logo, colors, and labels — to match your brand identity. See the White Labeling documentation for full configuration options.

General

Section titled “General”

Signing Key

Section titled “Signing Key”

For background operations (sending generated telemetry, continuous prediction model fitting, forecasting), Trendz must authenticate with ThingsBoard on behalf of a user. Storing user credentials in memory is insecure — instead, Trendz uses a JWT signing key stored in configuration files on the server.

The Signing Key panel at the bottom of the Settings page shows the current key status:

Signing key status: not valid Signing key status: valid

Getting the signing key from ThingsBoard

  1. Log in to ThingsBoard as a System Administrator.

    ThingsBoard system administrator login screen

  2. Go to Security → General.

    Security → General page in ThingsBoard

  3. Scroll to the JWT Security Settings section and copy the value from the Signing key field.

    JWT Security Settings section with the signing key field

Applying the signing key

Once you have the key, add it to the Trendz configuration for your installation type:

Ubuntu installation
  1. SSH into the server running Trendz.
  2. Open the Trendz configuration file:
    Terminal window
    sudo nano /etc/trendz/conf/trendz.conf
  3. Add the signing key at the end of the file:
    Terminal window
    export JWT_TOKEN_SIGNING_KEY=<signing-key>
    Signing key added to the Trendz config file on Ubuntu
  4. Save the file and restart the Trendz service.
Docker Compose installation
  1. Open your docker-compose.yml file.
  2. Add an environment variable under the Trendz service: 
    environment:
      - JWT_TOKEN_SIGNING_KEY=<signing-key>
    JWT_TOKEN_SIGNING_KEY environment variable in docker-compose.yml
  3. Save the file and restart the Trendz container.

Trendz Widget Bundle

Section titled “Trendz Widget Bundle”

The Trendz Widget Bundle must be uploaded to enable sharing Trendz views in ThingsBoard dashboards. See embedding Trendz visuals in ThingsBoard for usage instructions.

The Trendz Widget Bundle section shows one of the following statuses:

Status Meaning
Not installed The bundle is missing.
Update required A newer version is available.
Latest version installed No action needed.
Bundle is invalid The current bundle is corrupted or incomplete.

If the status is anything other than Latest version installed, click the Upload bundle button to install or update it.

Trendz JS Summary Module

Section titled “Trendz JS Summary Module”

The Trendz JS Summary Module is recommended for configuring AI Widget Summaries across ThingsBoard widgets. See AI Widget Summary for configuration instructions.

The Trendz JS Summary Module section shows one of the following statuses:

Status Meaning
Not installed The module is missing.
Update required A newer version is available.
Latest version installed No action needed.

If the status is anything other than Latest version installed, click the Upload Module button to install or update it.