Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions _config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -97,11 +97,11 @@ release:
# In short form (e.g. v4.3)
wd_examples_commit: v4.3.0.1
# >>> EDGE
edge_ver: 4.3
edge_tag: v4.3
edge_full_ver: 4.3.0EDGE
pe_edge_ver: 4.3pe
pe_edge_full_ver: 4.3.0EDGEPE
edge_ver: 4.3.0.1
edge_tag: v4.3.0.1
edge_full_ver: 4.3.0.1EDGE
pe_edge_ver: 4.3.0.1pe
pe_edge_full_ver: 4.3.0.1EDGEPE
# <<< EDGE
ce_flutter_app_ver: 1.8.0
pe_flutter_app_ver: 1.8.0
Expand Down
4 changes: 3 additions & 1 deletion _data/upgrade-instructions-data.yml
Original file line number Diff line number Diff line change
@@ -1,19 +1,21 @@
4.3.0.1:
upgradable-from: "4.2.1.x"
release-date: Feb 3 2026
release-date-edge: Feb 4, 2026
lts: "true"
patch: "true"
x: "true"
4.3.0:
vulnerable: "true"
upgradable-from: "4.2.1.x"
release-date: Jan 20 2026
release-date-edge: Jan 21, 2026
release-date-edge: Jan 21 2026
lts: "true"
x: "true"
4.2.1.2:
upgradable-from: "4.2.0"
release-date: Feb 3 2026
release-date-edge: Feb 4, 2026
lts: "true"
patch: "true"
x: "true"
Expand Down
5 changes: 5 additions & 0 deletions _includes/docs/pe/edge/edge-releases-table/v4-2-1-2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
## v4.2.1.2 (Feb 4, 2026)

**Patch** release with everything from:
* [TB CE v4.2.1.2](/docs/releases/releases-table/v4-2-x/#thingsboard-ce-v4212-feb-3-2026){: target="_blank"}:
* [TB PE v4.2.1.2](/docs/pe/releases/releases-table/v4-2-x/#thingsboard-pe-v4212-feb-3-2026){: target="_blank"}:
5 changes: 5 additions & 0 deletions _includes/docs/pe/edge/edge-releases-table/v4-3-0-1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
## v4.3.0.1 (Feb 4, 2026)

**Patch** release with everything from:
* [TB CE v4.3.0.1](/docs/releases/releases-table/v4-3-x/#thingsboard-ce-v4301-feb-3-2026){: target="_blank"}:
* [TB PE v4.3.0.1](/docs/pe/releases/releases-table/v4-3-x/#thingsboard-pe-v4301-feb-3-2026){: target="_blank"}:
3 changes: 3 additions & 0 deletions _includes/docs/releases/edge-releases-table/v4-2-1-2.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
## v4.2.1.2 (Feb 4, 2026)

**Patch** release with everything from [TB CE v4.2.1.2](/docs/releases/releases-table/v4-2-x/#thingsboard-ce-v4212-feb-3-2026){: target="_blank"}:
3 changes: 3 additions & 0 deletions _includes/docs/releases/edge-releases-table/v4-3-0-1.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
## v4.3.0.1 (Feb 4, 2026)

**Patch** release with everything from [TB CE v4.3.0.1](/docs/releases/releases-table/v4-3-x/#thingsboard-ce-v4301-feb-3-2026){: target="_blank"}:
7 changes: 4 additions & 3 deletions _includes/releases-table.liquid
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,8 @@

<div class="releases-table-content-item">
{{ version | replace: "-", "." | replace: ".x", "" }}{% if docsPrefix == "pe/" %}PE
{%- elsif docsPrefix == "edge/" or docsPrefix == "pe/edge/" -%}Edge
{%- elsif docsPrefix == "edge/" -%}Edge
{%- elsif docsPrefix == "pe/edge/" -%}PE Edge
{%- endif -%}
</div>

Expand Down Expand Up @@ -133,8 +134,8 @@
</div>
</div>
<ul class="legend{% if docsPrefix == "pe/" %} pe{% elsif docsPrefix == "edge/" %} edge{% elsif docsPrefix == "pe/edge/" %} pe-edge{% endif %}">
<li class="list-link"><a href="/docs/{{ docsPrefix }}releases/release-policy/">Active LTS</a> - releases supported for 18 months from initial release date</li>
<li class="list-link"><a href="/docs/{{ docsPrefix }}releases/release-policy/">Maintenance LTS</a> - older LTS releases still supported within the LTS window</li>
<li class="list-link"><a href="/docs/{{ docsPrefix }}releases/release-policy/" target="_blank">Active LTS</a> - releases supported for 18 months from initial release date</li>
<li class="list-link"><a href="/docs/{{ docsPrefix }}releases/release-policy/" target="_blank">Maintenance LTS</a> - older LTS releases still supported within the LTS window</li>
<li>Standard - releases supported for 6 months from initial release date</li>
</ul>
<div class="fixed-upgrade-scrollbar" id="fixedScrollbar">
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,9 +40,15 @@ If **ThingsBoard Edge** is set to run on the **same machine** where the **{{appP

Ensure that the ports **18080, 11883, 15683-15688** are not used by any other application.

Then, update the port configuration in the **docker-compose.yml** file:
{% endcapture %}

{% include templates/info-banner.md content=local-deployment %}

To update the port configuration in the **docker-compose.yml** file, run:

**sed -i 's/8080:8080/18080:8080/; s/1883:1883/11883:1883/; s/5683-5688:5683-5688\/udp/15683-15688:5683-5688\/udp/' docker-compose.yml**
```bash
sed -i 's/8080:8080/18080:8080/; s/1883:1883/11883:1883/; s/5683-5688:5683-5688\/udp/15683-15688:5683-5688\/udp/' docker-compose.yml
```
{: .copy-code}

{% endcapture %}{% include templates/info-banner.md content=local-deployment %}

37 changes: 37 additions & 0 deletions _includes/templates/edge/install/info-patch-upgrade.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
{% capture patch_restrictions %}
If you are upgrading from **{{minorVersion}}**, you **MUST** run the script below. However, if you are upgrading from version **{{mainteneceVersion}}**,
**DO NOT** run the upgrade script; proceed directly to starting the Edge service.
{% endcapture -%}

{% include templates/warn-banner.md content=patch_restrictions %}

{% if page.url contains 'centos' or page.url contains 'ubuntu' %}

Upgrade the **ThingsBoard Edge** service:
```bash
sudo /usr/share/tb-edge/bin/install/upgrade.sh
```
{: .copy-code}

{% elsif page.url contains 'windows' %}
Upgrade the **ThingsBoard Edge** service:
```bash
C:\tb-edge>upgrade.bat
```
{: .copy-code}
**Note:** The upgrade script must be run with Administrator privileges.

{% elsif docsPrefix == "pe/edge/" and page.url contains 'docker' %}
Upgrade the **ThingsBoard Edge** service:
```bash
docker compose run mytbedge upgrade-tb-edge-pe.sh
```
{: .copy-code}

{% elsif docsPrefix == "edge/" and page.url contains 'docker' %}
Upgrade the **ThingsBoard Edge** service:
```bash
docker compose run mytbedge upgrade-tb-edge.sh
```
{: .copy-code}
{% endif %}
28 changes: 0 additions & 28 deletions _includes/templates/edge/user-guide/start-upgrade-patch-pe.md

This file was deleted.

24 changes: 0 additions & 24 deletions _includes/templates/edge/user-guide/start-upgrade-patch.md

This file was deleted.

9 changes: 2 additions & 7 deletions _includes/templates/edge/user-guide/start-upgrade-pe.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,15 +20,10 @@ sed -i 's|thingsboard/tb-edge-pe:{{previousVersion}}|thingsboard/tb-edge-pe:{{ve
```
{: .copy-code}

Upgrade the **ThingsBoard Edge** service:

```bash
docker compose run mytbedge upgrade-tb-edge.sh
```
{: .copy-code}
{% include templates/edge/install/info-patch-upgrade.md %}

Start the docker compose:
```
```bash
docker compose up -d && docker compose logs -f mytbedge
```
{: .copy-code}
Expand Down
7 changes: 1 addition & 6 deletions _includes/templates/edge/user-guide/start-upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,7 @@ sed -i 's|thingsboard/tb-edge:{{previousVersion}}|thingsboard/tb-edge:{{versionN
```
{: .copy-code}

Upgrade the **ThingsBoard Edge** service:

```bash
docker compose run mytbedge upgrade-tb-edge.sh
```
{: .copy-code}
{% include templates/edge/install/info-patch-upgrade.md %}

To start this docker compose, run the following command:
```
Expand Down
1 change: 1 addition & 0 deletions docs/edge/releases/releases-table/v4-2-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ effective-url: '/docs/edge/releases/releases-table/'
* TOC
{:toc}

{% include docs/releases/edge-releases-table/v4-2-1-2.md %}
{% include docs/releases/edge-releases-table/v4-2-1-1.md %}
{% include docs/releases/edge-releases-table/v4-2-1.md %}
{% include docs/releases/edge-releases-table/v4-2-0.md %}
2 changes: 1 addition & 1 deletion docs/edge/releases/releases-table/v4-3-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,5 @@ effective-url: '/docs/edge/releases/releases-table/'
* TOC
{:toc}

{% include docs/releases/edge-releases-table/v4-3-0-1.md %}
{% include docs/releases/edge-releases-table/v4-3-0.md %}

20 changes: 4 additions & 16 deletions docs/edge/releases/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,20 +11,8 @@ description: Upcoming releases
The product roadmap below covers only **major features** and does not include minor enhancements and bug fixes.
View active development and bug fixes for the latest release [on our GitHub repository](https://github.com/thingsboard/thingsboard-edge/tree/rc){: target="_blank"}.

## v4.3.0 (Jan 21, 2026)
## v4.4.0

**Major** release with everything from [TB CE v4.3.0](/docs/releases/releases-table/v4-3-x/){: target="_blank"}:

**Improvements**

* [#13998](https://github.com/thingsboard/thingsboard/pull/13998){: target="_blank"} **AI Model synchronization:** Added automatic synchronization of AI models to Edge instances for local AI processing capabilities by [@jekka001](https://github.com/jekka001){: target="_blank"};
* [#14352](https://github.com/thingsboard/thingsboard/pull/14352){: target="_blank"} **User and credential synchronization for Edge:** Added support for syncing User entities and UserCredentials from Edge to Cloud, enabling centralized user management by [@volodymyr-babak](https://github.com/volodymyr-babak){: target="_blank"};
* [#14447](https://github.com/thingsboard/thingsboard/pull/14447){: target="_blank"} **Entity deletion sync for Edge:** Modified edge-to-cloud synchronization to propagate actual entity deletions (assets, devices, dashboards, entity views) instead of just unassigning them by [@MazurenkoNick](https://github.com/MazurenkoNick){: target="_blank"};
* [#14603](https://github.com/thingsboard/thingsboard/pull/14603){: target="_blank"} **Edge Events optimization:** Added merge and filter functionality for duplicate Edge Events in the downlink message pipeline, reducing the number of events sent to edge devices by consolidating attribute updates and removing exact duplicates by [@volodymyr-babak](https://github.com/volodymyr-babak){: target="_blank"};
* [#209](https://github.com/thingsboard/thingsboard-edge/pull/209){: target="_blank"} **Downlink duplicate merging:** Implemented merge and filter functionality for duplicate downlink messages, optimizing Edge communication by [@volodymyr-babak](https://github.com/volodymyr-babak){: target="_blank"};
* [#208](https://github.com/thingsboard/thingsboard-edge/pull/208){: target="_blank"} **Refactor BaseCloudManagerService and its implementations** by [@MazurenkoNick](https://github.com/MazurenkoNick){: target="_blank"};
* [#14489](https://github.com/thingsboard/thingsboard/pull/14489){: target="_blank"} **Edge update deduplication:** Reduced duplicate entity updates in edge processors by introducing generateUniqueNameIfDuplicateExists functionality by [@MazurenkoNick](https://github.com/MazurenkoNick){: target="_blank"};

### Bug fixes

* [#13843](https://github.com/thingsboard/thingsboard/pull/13843){: target="_blank"} **Improved Edge session cleanup** to prevent resource leaks and message backlog due to unstable network conditions and Kafka busy timeout by [@bcblr1993](https://github.com/bcblr1993){: target="_blank"}.
**Major** release with everything from **ThingsBoard CE**, plus:
* ThingsBoard Runner - Docker service for installation and upgrade of Edge instances and IoT Gateway on remote machines from the ThingsBoard UI in one click.
* Edge homepage - new section providing a centralized, at-a-glance overview of all Edge instances, including statistics, alarms, connection status, and uplink/downlink rates.
1 change: 1 addition & 0 deletions docs/pe/edge/releases/releases-table/v4-2-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,7 @@ effective-url: '/docs/pe/edge/releases/releases-table/'
* TOC
{:toc}

{% include docs/pe/edge/edge-releases-table/v4-2-1-2.md %}
{% include docs/pe/edge/edge-releases-table/v4-2-1-1.md %}
{% include docs/pe/edge/edge-releases-table/v4-2-1.md %}
{% include docs/pe/edge/edge-releases-table/v4-2-0.md %}
3 changes: 2 additions & 1 deletion docs/pe/edge/releases/releases-table/v4-3-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,5 +16,6 @@ effective-url: '/docs/edge/releases/releases-table/'
* TOC
{:toc}

{% include docs/releases/edge-releases-table/v4-3-0.md %}
{% include docs/pe/edge/edge-releases-table/v4-3-0-1.md %}
{% include docs/pe/edge/edge-releases-table/v4-3-0.md %}

8 changes: 3 additions & 5 deletions docs/pe/edge/releases/roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,7 @@ effective-url: '/docs/pe/edge/releases/roadmap/'

The product roadmap below covers only **major features** and does not include minor enhancements and bug fixes.

## v4.3.0 (Jan 21, 2026)
## v4.4.0

**Major** release with everything from:
* Edge CE [v4.3 release notes](){: target="_blank"}
* ThingsBoard CE [v4.3 release notes](/docs/releases/releases-table/v4-3-x/#thingsboard-ce-v430-jan-20-2026){: target="_blank"}
* ThingsBoard PE [v4.3 release notes](/docs/pe/releases/releases-table/v4-3-x/#thingsboard-pe-v430-jan-20-2026){: target="_blank"}
**Major** release that includes all [Edge CE 4.4 features](/docs/edge/releases/roadmap/){: target="_blank"}, plus:
* Solution templates with Edge computing integration
53 changes: 7 additions & 46 deletions docs/user-guide/install/edge/upgrade-instructions/centos/v4-2-x.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,18 @@ effective-url: '/docs/user-guide/install/edge/upgrade-instructions/'
* TOC
{:toc}

## Upgrading Edge CE to 4.2.1.1
## Upgrading Edge CE to 4.2.1 (4.2.1.2)

{% assign updateServerLink = "centos/v4-2-x/#upgrading-thingsboard-ce-to-4211" %}
{% assign updateServerLink = "centos/v4-2-x/#upgrading-thingsboard-ce-to-latest-421-4212" %}
{% assign previousVersion = "4.2.1" %}
{% assign minorVersion = "4.2.0" %}
{% assign mainteneceVersion = "4.2.1.x" %}
{% include templates/edge/install/compatibility-warning-version.md %}

### Download the Edge package

```bash
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v4.2.1.1/tb-edge-4.2.1.1.rpm
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v4.2.1.2/tb-edge-4.2.1.2.rpm
```
{: .copy-code}

Expand All @@ -35,54 +37,13 @@ sudo service tb-edge stop
### Upgrade the package

```bash
sudo rpm -Uvh tb-edge-4.2.1.1.rpm
sudo rpm -Uvh tb-edge-4.2.1.2.rpm
```
{: .copy-code}

**Note:** The package installer may prompt you to merge configuration files. Select the **merge option** to preserve your existing settings.

### Start the Edge service

```bash
sudo service tb-edge start
```
{: .copy-code}

## Upgrading Edge CE to 4.2.1

{% assign updateServerLink = "centos/v4-2-x/#upgrading-thingsboard-ce-to-421" %}
{% assign previousVersion = "4.2.0" %}
{% include templates/edge/install/compatibility-warning-version.md %}

### Download the Edge package

```bash
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v4.2.1/tb-edge-4.2.1.rpm
```
{: .copy-code}

Stop the ThingsBoard Edge service before upgrading to prevent file conflicts:

```bash
sudo service tb-edge stop
```
{: .copy-code}

### Upgrade the package

```bash
sudo rpm -Uvh tb-edge-4.2.1.rpm
```
{: .copy-code}

**Note:** The package installer may prompt you to merge configuration files. Select the **merge option** to preserve your existing settings.

Execute the upgrade script to migrate your data and configurations:

```bash
sudo /usr/share/tb-edge/bin/install/upgrade.sh
```
{: .copy-code}
{% include templates/edge/install/info-patch-upgrade.md %}

### Start the Edge service

Expand Down
Loading