ThingsBoard Edge Docker 4.2.x Upgrade Instructions

Upgrading Edge to 4.2.2.8 (latest 4.2.2 patch)

Backup before upgrading

Go to your docker-compose.yml directory and stop the container:

docker compose stop

Create a backup copy of the database volume:

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

If you installed Edge with Docker on Windows, the database volume is mytb-edge-data-db: use it in place of tb-edge-postgres-data.

Update the image version

Update the thingsboard/tb-edge image tag in docker-compose.yml to 4.2.2.8EDGE:

sed -i -E 's#thingsboard/tb-edge:[^" ]+#thingsboard/tb-edge:4.2.2.8EDGE#' docker-compose.yml

On Windows, PowerShell has no sed: open docker-compose.yml in a text editor and set the image: line of the mytbedge service to thingsboard/tb-edge:4.2.2.8EDGE.

Start the container

docker compose up -d
docker compose logs -f mytbedge

Upgrading Edge to 4.2.1.2 (latest 4.2.1 patch)

Backup before upgrading

Go to your docker-compose.yml directory and stop the container:

docker compose stop

Create a backup copy of the database volume:

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

If you installed Edge with Docker on Windows, the database volume is mytb-edge-data-db: use it in place of tb-edge-postgres-data.

Update the image version

Update the thingsboard/tb-edge image tag in docker-compose.yml to 4.2.1.2EDGE:

sed -i -E 's#thingsboard/tb-edge:[^" ]+#thingsboard/tb-edge:4.2.1.2EDGE#' docker-compose.yml

On Windows, PowerShell has no sed: open docker-compose.yml in a text editor and set the image: line of the mytbedge service to thingsboard/tb-edge:4.2.1.2EDGE.

Start the database. If your docker-compose.yml also has kafka or cassandra services, add them to the command:

docker compose up -d postgres

Run the upgrade script:

docker compose run --rm mytbedge upgrade-tb-edge.sh

Start the container

docker compose up -d
docker compose logs -f mytbedge

Upgrading Edge to 4.2

Backup before upgrading

Go to your docker-compose.yml directory and stop the container:

docker compose stop

Create a backup copy of the database volume:

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

If you installed Edge with Docker on Windows, the database volume is mytb-edge-data-db: use it in place of tb-edge-postgres-data.

Update the image version

Update the thingsboard/tb-edge image tag in docker-compose.yml to 4.2.0EDGE:

sed -i -E 's#thingsboard/tb-edge:[^" ]+#thingsboard/tb-edge:4.2.0EDGE#' docker-compose.yml

On Windows, PowerShell has no sed: open docker-compose.yml in a text editor and set the image: line of the mytbedge service to thingsboard/tb-edge:4.2.0EDGE.

Start the database. If your docker-compose.yml also has kafka or cassandra services, add them to the command:

docker compose up -d postgres

Run the upgrade script:

docker compose run --rm mytbedge upgrade-tb-edge.sh

Start the container

docker compose up -d
docker compose logs -f mytbedge