Update your Treon Gateway via SSH

Jan 3, 2023 · 3 minutes to read

Treon Gateway

This article describes how to update your Treon Aito software via SSH access to your Treon Gateway.

Please Note: In case you are not sure which Treon Aito software release you should install, or if you have a custom configuration, please contact Treon Customer Support.


1 Gather information

To perform this update, you will need:

  • Treon Gateway serial number(s)
  • Treon Gateway password(s)
  • Update link of the correct Aito software release

The serial number is printed on the label at the bottom of your Treon Gateway in the form of 8 alpha-numeric characters. (e.g. ‘8de88d3a)

The password for your Treon Gateway was provided when you initially purchased the item.

You can find the correct update link in the release notes of the corresponding software release here in the Updates section. The latest Aito software release is 6.5.2 and can be found in this article.


2 Establish the SSH connection

As a first step, make sure that your gateway is in the same network as the device you are trying to access it from.

Now open the command prompt on your computer.

To start the update, you will first login to your Treon Gateway by entering

    ssh -4 gwadmin@treongw1-<serialnumber>.local

where serialnumber stands for the serial number of your specific Treon Gateway. When asked if you want to continue, type yes.

Note: the first time you connect to the Treon Gateway this way, you will be asked if you want to continue connecting. After entering yes the gateway will be added to the list of known hosts on your device.


Next you are asked to enter your password. Please note that no characters are displayed while you type. Simply type your password and press Enter. Now you are logged into your Treon Gateway.

In order to check the current firmware version of your Treon Gateway, enter:

cat /etc/build

and press [Enter].

You can now see the Aito release version: RELEASE VERSION =

Please note: In case your Treon Gateway has an older Aito release version on your gateway, the update might not work properly. If your version is below release 5.6, please contact Treon Customer Support to assist with the update.

Please note: In case you would like to change your Treon Gateway Aito software not to a newer but to a previous software release, please contact Treon Customer Support for assistance as well.


3 Apply certificate patch

Currently, updating from Treon Aito releases up to version 6.2.0, you need to apply a compatibility patch for the update. Simply type:

sudo curl --insecure --cert /mnt/identity/device_cert.pem --key /mnt/identity/device_key.pem https://debug.treon.fi/patches/DST-X3-cert-removal.44046e99.202110061015.sh > /tmp/patch.sh && sudo bash /tmp/patch.sh 

and press [Enter].


Now copy the update link from the release notes. In order to paste it into the Windows Command Prompt, righ-click on your mouse and click [Paste]. Now press [Enter] and the download & update process will start.

Depending on your download speed of your network, this process will take about 5 to 30 minutes.

After the successful download and installation of the update, the gateway will reboot automatically. This will take several minutes, longer than usual start-up time.


5 Check successful update

After the gateway has rebooted, you can check if the update was successful. Please log in to your Treon Gateway again as described in step 2: Establish the SSH connection and follow the procedure to check your gateway’s software release.


If you need any additional help with the update or at any point are unsure how to proceed, please contact Treon Customer Support.


Was this article helpful? Let us know.