Upgrade Instructions

• Prepare for upgrading ThingsBoard Edge
  • Ubuntu/CentOS/Raspberry Pi
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.9.1EDGE
  • Ubuntu/CentOS/Raspberry Pi
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.9EDGE
  • Ubuntu/CentOS/Raspberry Pi
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.8EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.7EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.6.4EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.6.3EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.6.2EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.6.1EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.6.0EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.5.1.1EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.5.1EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows
• Upgrading to 3.5.0EDGE
  • Ubuntu/CentOS
  • Docker (Linux or Mac OS)
  • Windows

Before upgrading ThingsBoard Edge, ensure that ThingsBoard Server is updated to the latest version.

Additionally, verify that the ThingsBoard Edge and ThingsBoard Server versions are compatible.

Version Compatibility Rules:

• ThingsBoard Edge version X.Y.Z works with the ThingsBoard Server version X.Y.Z and the next two versions.

ThingsBoard Edge 3.8.0 works with ThingsBoard Server 3.8.0 and two later versions (3.9.0 and 3.9.1). You can view the ThingsBoard Server Release Notes here.

• ThingsBoard Edge version X.Y.Z does not work with older ThingsBoard Server versions.

ThingsBoard Edge 3.9.1 does not support ThingsBoard Server 3.8.0 or any earlier versions. In such cases, the ThingsBoard Server must be upgraded to the latest version first.

If you run an older version of ThingsBoard Edge (e.g., version 3.6.0), the ThingsBoard team cannot guarantee the availability or proper functioning of all features.

Prepare for upgrading ThingsBoard Edge

Ubuntu/CentOS/Raspberry Pi

Stop ThingsBoard Edge service:

1
sudo systemctl stop tb-edge

Backup Database

Make a backup of the database before upgrading.

Make sure you have enough space to place a backup of the database

Check database size

1
sudo -u postgres psql -c "SELECT pg_size_pretty( pg_database_size('tb_edge') );"

Check free space

1
df -h /

If there is enough free space - make a backup.

1
sudo -Hiu postgres pg_dump tb_edge > tb_edge.sql.bak

Check backup file created successfully.

Docker (Linux or Mac OS)

Set the terminal in the directory which contains the docker-compose.yml file and execute the following command to stop and remove currently running TB Edge container:

1
docker compose stop && docker compose rm mytbedge -f

If you are still using docker-compose (with a hyphen), it is recommended to update your stack to match the latest documentation.

Backup Database Volume

Make a copy of the database volume before upgrading:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

Backup Database Bind Mount Folder (deprecated)

If you are still using Docker bind mount folders, please ensure to make a copy of the database folder before proceeding with the upgrade:

1
sudo cp -r ~/.mytb-edge-data/db ~/.mytb-edge-db-BACKUP

Windows

Stop ThingsBoard Edge service:

1
net stop tb-edge

Backup Database

Launch the “pgAdmin” software and login as superuser (postgres). Open your server and create backup of database tb_edge using ‘Backup Dialog’ functionality of “pgAdmin”.

Upgrading to 3.9.1EDGE

Please make sure that ThingsBoard Server version is 3.9.1 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.9.1, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS/Raspberry Pi

NOTE: These steps are applicable for ThingsBoard Edge 3.9EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.9.1/tb-edge-3.9.1.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.9.1/tb-edge-3.9.1.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.9.1.deb

1
sudo rpm -Uvh tb-edge-3.9.1.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard 3.9.0EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.9.1EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.9.0EDGE|thingsboard/tb-edge:3.9.1EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.9EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.9.1.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat

Start the service

1
net start tb-edge

Upgrading to 3.9EDGE

Please make sure that ThingsBoard Server version is 3.9 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.9, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS/Raspberry Pi

NOTE: These steps are applicable for ThingsBoard Edge 3.8EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.9/tb-edge-3.9.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.9/tb-edge-3.9.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.9.deb

1
sudo rpm -Uvh tb-edge-3.9.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.8.0

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard 3.8.0EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.9.0EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.8.0EDGE|thingsboard/tb-edge:3.9.0EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.8EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.9.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.8.0

Start the service

1
net start tb-edge

Upgrading to 3.8EDGE

Please make sure that ThingsBoard Server version is 3.8 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.8, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.7EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.8/tb-edge-3.8.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.8/tb-edge-3.8.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.8.deb

1
sudo rpm -Uvh tb-edge-3.8.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.7.0

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard 3.7.0EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.8.0EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.7.0EDGE|thingsboard/tb-edge:3.8.0EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.7EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.8.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.7.0

Start the service

1
net start tb-edge

Upgrading to 3.7EDGE

Please make sure that ThingsBoard Server version is 3.7 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.7, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.6.4EDGE version.

Important note before upgrading to ThingsBoard 3.7

ThingsBoard backend was migrated to Java 17. Install JDK 17 and ensure that system’s default Java version is set to 17.

Please refer to Step 1 of the corresponding installation guide for detailed instructions:

Ubuntu

CentOS/RHEL

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.7/tb-edge-3.7.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.7/tb-edge-3.7.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.7.deb

1
sudo rpm -Uvh tb-edge-3.7.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.6.4

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard 3.6.4EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.7.0EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.6.4EDGE|thingsboard/tb-edge:3.7.0EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.6.4EDGE version.

Important note before upgrading to ThingsBoard 3.7

ThingsBoard backend was migrated to Java 17. Install JDK 17 and ensure that system’s default Java version is set to 17.

Please refer to Step 1 of the installation guide for detailed instructions.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.7.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.6.4

Start the service

1
net start tb-edge

Upgrading to 3.6.4EDGE

Please make sure that ThingsBoard Server version is 3.6.4 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.6.4, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.6.3EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.4/tb-edge-3.6.4.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.4/tb-edge-3.6.4.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.6.4.deb

1
sudo rpm -Uvh tb-edge-3.6.4.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.6.3

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard 3.6.3EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.6.4EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.6.3EDGE|thingsboard/tb-edge:3.6.4EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.6.3EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.6.4.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.6.3

Start the service

1
net start tb-edge

Upgrading to 3.6.3EDGE

Please make sure that ThingsBoard Server version is 3.6.3 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.6.3, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.6.2EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.3/tb-edge-3.6.3.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.3/tb-edge-3.6.3.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.6.3.deb

1
sudo rpm -Uvh tb-edge-3.6.3.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.6.2

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard 3.6.2EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.6.3EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.6.2EDGE|thingsboard/tb-edge:3.6.3EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.6.2EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.6.3.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.6.2

Start the service

1
net start tb-edge

Upgrading to 3.6.2EDGE

Please make sure that ThingsBoard Server version is 3.6.2 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.6.2, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.6.1EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.2/tb-edge-3.6.2.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.2/tb-edge-3.6.2.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.6.2.deb

1
sudo rpm -Uvh tb-edge-3.6.2.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.6.1

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard Edge 3.6.1EDGE version.

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

Migrating Data from Docker Bind Mount Folders to Docker Volumes

Starting with the 3.6.2EDGE release, the ThingsBoard team has moved from using Docker bind mount folders to Docker volumes. The goal of this change is to improve security and efficiency when storing data for Docker containers, and to mitigate permissions issues in different environments.

To migrate from Docker bind mounts to Docker volumes, please execute the following commands:

1
2
3
docker run --rm -v tb-edge-data:/volume -v ~/.mytb-edge-data:/backup busybox sh -c "cp -a /backup/. /volume"
docker run --rm -v tb-edge-logs:/volume -v ~/.mytb-edge-logs:/backup busybox sh -c "cp -a /backup/. /volume"
docker run --rm -v tb-edge-postgres-data:/volume -v ~/.mytb-edge-data/db:/backup busybox sh -c "cp -a /backup/. /volume"

After the data migration to the newly created Docker volumes is complete, you’ll need to update the volume mounts in your Docker Compose configuration. Modify the `docker-compose.yml’ file for ThingsBoard Edge to update the volume settings.

First, please update docker compose file version. Find the next snippet:

1
2
version: '3.0'
...

And replace it with:

1
version: '3.8'

Then update the volume mounts. Locate the following snippet:

1
2
3
4
    volumes:
      - ~/.mytb-edge-data:/data
      - ~/.mytb-edge-logs:/var/log/tb-edge
...

And replace it with:

1
2
3
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge

Apply a similar update to the PostgreSQL service. Locate the section:

1
2
3
    volumes:
      - ~/.mytb-edge-data/db:/var/lib/postgresql/data
...

And replace it with:

1
2
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

Finally, add the following volume section to the end of the file:

1
2
3
4
5
6
7
volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data

Backup Database

Before upgrading, make a copy of the database volume:

1
docker run --rm -v tb-edge-postgres-data:/source -v tb-edge-postgres-data-backup:/backup busybox sh -c "cp -a /source/. /backup"

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.8'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.6.2EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - tb-edge-data:/data
      - tb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - tb-edge-postgres-data:/var/lib/postgresql/data

volumes:
  tb-edge-data:
    name: tb-edge-data
  tb-edge-logs:
    name: tb-edge-logs
  tb-edge-postgres-data:
    name: tb-edge-postgres-data
  EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.6.1EDGE|thingsboard/tb-edge:3.6.2EDGE|' docker-compose.yml

To start this docker compose, run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.6.1EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.6.2.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.6.1

Start the service

1
net start tb-edge

Upgrading to 3.6.1EDGE

Please make sure that ThingsBoard Server version is 3.6.1 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.6.1, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.6.0EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.1/tb-edge-3.6.1.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6.1/tb-edge-3.6.1.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.6.1.deb

1
sudo rpm -Uvh tb-edge-3.6.1.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.6.0

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard Edge 3.6.0EDGE version.

Execute the following command to pull 3.6.1EDGE image:

1
docker pull thingsboard/tb-edge:3.6.1EDGE

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.0'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.6.1EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - ~/.mytb-edge-data:/data
      - ~/.mytb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - ~/.mytb-edge-data/db:/var/lib/postgresql/data
  EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.6.0EDGE|thingsboard/tb-edge:3.6.1EDGE|' docker-compose.yml

To start this docker compose , run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.6.0EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.6.1.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.6.0

Start the service

1
net start tb-edge

Upgrading to 3.6.0EDGE

Please make sure that ThingsBoard Server version is 3.6.0 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.6.0, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.5.1.1EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6/tb-edge-3.6.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.6/tb-edge-3.6.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.6.deb

1
sudo rpm -Uvh tb-edge-3.6.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.5.1

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard Edge 3.5.1.1EDGE version.

Execute the following command to pull 3.6.0EDGE image:

1
docker pull thingsboard/tb-edge:3.6.0EDGE

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.0'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.6.0EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - ~/.mytb-edge-data:/data
      - ~/.mytb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - ~/.mytb-edge-data/db:/var/lib/postgresql/data
  EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.5.1.1EDGE|thingsboard/tb-edge:3.6.0EDGE|' docker-compose.yml

To start this docker compose , run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.5.1.1EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.6.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.5.1

Start the service

1
net start tb-edge

Upgrading to 3.5.1.1EDGE

Please make sure that ThingsBoard Server version is 3.5.1 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.5.1, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.5.1EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.5.1.1/tb-edge-3.5.1.1.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.5.1.1/tb-edge-3.5.1.1.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.5.1.1.deb

1
sudo rpm -Uvh tb-edge-3.5.1.1.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard Edge 3.5.1EDGE version.

Execute the following command to pull 3.5.1.1EDGE image:

1
docker pull thingsboard/tb-edge:3.5.1.1EDGE

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.0'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.5.1.1EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - ~/.mytb-edge-data:/data
      - ~/.mytb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - ~/.mytb-edge-data/db:/var/lib/postgresql/data
  EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.5.1EDGE|thingsboard/tb-edge:3.5.1.1EDGE|' docker-compose.yml

To start this docker compose , run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.5.1EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.5.1.1.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

Start the service

1
net start tb-edge

Upgrading to 3.5.1EDGE

Please make sure that ThingsBoard Server version is 3.5.1 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.5.1, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.5.0EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.5.1/tb-edge-3.5.1.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.5.1/tb-edge-3.5.1.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.5.1.deb

1
sudo rpm -Uvh tb-edge-3.5.1.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.5.0

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard Edge 3.5.0EDGE version.

Execute the following command to pull 3.5.1EDGE image:

1
docker pull thingsboard/tb-edge:3.5.1EDGE

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.0'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.5.1EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - ~/.mytb-edge-data:/data
      - ~/.mytb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - ~/.mytb-edge-data/db:/var/lib/postgresql/data
  EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.5.0EDGE|thingsboard/tb-edge:3.5.1EDGE|' docker-compose.yml

To start this docker compose , run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.5.0EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.5.1.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.5.0

Start the service

1
net start tb-edge

Upgrading to 3.5.0EDGE

Please make sure that ThingsBoard Server version is 3.5.0 or above before updating ThingsBoard Edge to this version.

If ThingsBoard Server version is below 3.5.0, please follow upgrade ThingsBoard server upgrade instructions first.

Ubuntu/CentOS

NOTE: These steps are applicable for ThingsBoard Edge 3.4.3EDGE version.

ThingsBoard Edge package download

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.5/tb-edge-3.5.deb

1
wget https://github.com/thingsboard/thingsboard-edge/releases/download/v3.5/tb-edge-3.5.rpm

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running.

1
sudo service tb-edge stop

1
sudo dpkg -i tb-edge-3.5.deb

1
sudo rpm -Uvh tb-edge-3.5.rpm

NOTE: Package installer may ask you to merge your tb-edge configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.

Execute regular upgrade script:

1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion=3.4.3

Start the service

1
sudo service tb-edge start

Docker (Linux or Mac OS)

NOTE: These steps are applicable for ThingsBoard Edge 3.4.3EDGE version.

Execute the following command to pull 3.5.0EDGE image:

1
docker pull thingsboard/tb-edge:3.5.0EDGE

Set the terminal in the directory which contains the “docker-compose.yml” file, and run the following command to stop and remove the currently running TB Edge container (if it’s still running):

1
docker compose stop && docker compose rm mytbedge -f

The next step creates a docker compose file for the ThingsBoard Edge upgrade process and runs the upgrade. Once the upgrade process is successfully completed, the TB Edge upgrade container is automatically stopped:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
cat > docker-compose-upgrade.yml <<EOF && docker compose -f docker-compose-upgrade.yml up --abort-on-container-exit
version: '3.0'
services:
  mytbedge:
    restart: on-failure
    image: "thingsboard/tb-edge:3.5.0EDGE"
    environment:
      SPRING_DATASOURCE_URL: jdbc:postgresql://postgres:5432/tb-edge
    volumes:
      - ~/.mytb-edge-data:/data
      - ~/.mytb-edge-logs:/var/log/tb-edge
    entrypoint: upgrade-tb-edge.sh
  postgres:
    restart: always
    image: "postgres:15"
    ports:
      - "5432"
    environment:
      POSTGRES_DB: tb-edge
      POSTGRES_PASSWORD: postgres
    volumes:
      - ~/.mytb-edge-data/db:/var/lib/postgresql/data
  EOF

Modify the main docker compose file (docker-compose.yml) for ThingsBoard Edge and update the image version:

1
sed -i 's|thingsboard/tb-edge:3.4.3EDGE|thingsboard/tb-edge:3.5.0EDGE|' docker-compose.yml

To start this docker compose , run the following command:

1
docker compose up -d && docker compose logs -f mytbedge

Windows

NOTE: These steps are applicable for ThingsBoard Edge 3.4.3EDGE version.

ThingsBoard Edge package download

Download ThingsBoard Edge package for Windows: tb-edge-windows-3.5.zip.

ThingsBoard Edge service upgrade

• Stop ThingsBoard Edge service if it is running:

1
net stop tb-edge

• Make a backup of previous ThingsBoard Edge configuration located in <ThingsBoard Edge install dir>\conf (for example: C:\tb-edge\conf).

• Extract ThingsBoard Edge package.

• Compare and merge your old ThingsBoard Edge configuration files (from the backup you made in the previous step) with new ones.

• Finally, run upgrade.bat script to upgrade ThingsBoard Edge to the new version.

NOTE Scripts listed below should be executed using Administrator Role.

Execute regular upgrade script:

1
C:\tb-edge>upgrade.bat --fromVersion=3.4.3

Start the service

1
net start tb-edge