Skip to main content

How to Create your Own Update Server

  • Updated

When Airtame does not have direct access to an update server, it can not update its firmware via the traditional OTA method. We always recommend using the latest firmware. For companies that do not have the ability to connect Airtame to a network with an internet connection for accessing the update server, here are the steps for how to set up a local update server on your network.

 

Requirements:

  • Running web server (Apache/IIS/SimpleHTTPServer/any other webserver).

  • The Airtame's device settings cannot be password protected. Please remove the password, update the Airtames, and then re-enable password protection. 

 

Steps:

  1. Create a folder to later place the updated files.

  2. Download the following files (this can be done manually from another network):  Please copy the links and open them in a new tab. This should download one file for each link.

    For Airtame 2
    https://airtame-firmware.b-cdn.net/firmware/DG2/ga/airtame-fw-v5.4.0.rootfs.md5
    https://airtame-firmware.b-cdn.net/firmware/DG2/ga/airtame-fw-v5.4.0.rootfs.size
    https://airtame-firmware.b-cdn.net/firmware/DG2/ga/airtame-fw-v5.4.0.rootfs.gz


    Note: these are the links to the latest firmware versions for both Airtame 2 and Airtame 1. If you need any previous versions, you can change the version number in the URL to match one of the previous firmware versions (ex. change 4.2.0 to 3.9.2, etc). You can find the list of previous firmware versions here: Changelog.

    3. Run your web server to make your folder publicly available via HTTP.

    4. Send the following command to your device: 

    curl -X PUT --data '{ "legacy_updater": true }' http://<DEVICE_IP_HERE>/admin/settings

    5. Reboot your device. 

    6. Send the following command to your device:

    curl -X POST -d '{"url": "address_of_your_local_webserver/path/to/update_folder/{your_version}"}' http://device_ip_address/admin/device/update

 

Real examples:

 

curl -X POST -d '{"url": "http://192.168.1.6:8000/DG2_update_folder_331/airtame-fw-v3.3.1"}' http://192.168.1.13/admin/device/update       

 

curl -X POST -d '{"url": "http://192.168.1.6:8000/DG2_update_folder_latest/latest"}' http://192.168.1.13/admin/device/update 

 

Keep in mind:

This feature is in beta. This feature will work for releases after FW v3.3.0.

 

Be careful when saving files  — some browsers save

airtame-fw-v3.3.1.rootfs.size as airtame-fw-v3.3.1.rootfs.size.txt.

If this happens, make sure the file has the proper extension.

 

Bear in mind that the MD5 checksum is not for the archive but for the rootfs partition inside the image. So the MD5 sum won't match with .gz file, which is OK and expected.

Related articles