Ionoid IoT Documentation

# IoT Apps deployment

Ionoid.io make it easy to deploy IoT and Edge Linux apps on devices, in just few clicks, you can deploy your app on hundreds or thousands of devices.

The dashboard also provides a way to deploy on a subset of devices, using filters based on device names (for example, deploy only on devices with names matching weather-station-*), or devices with a specific status (for example device with status error to fix a bug).

From dashboard you can update your applications, but also rollback to previous version in case of errors.

In the next sections, we consider that you have:

If not, please follow the guidelines on the links above then return to this page.

# Deploy IoT Apps

To deploy an IoT app you have three options:

# Deploy on a single device

Click on Deploy App Button

  • On the window that appears, you can optionally add/remove environment variables for this app

  • Paste a public accessible URL to your app, and click on the Deploy button

TIP

If you have not yet an app on hand, you can test our Hello World test app, for that, use this public URL for ARMv6 devices, and this public URL for ARMv7 devices to deploy the version v0.1.

After few seconds, you will receive realtime messages about the status and progress of the app deployment on the device.

Paste the App Public URL

Once the app deployed on this device, you can see it listed on the project app list page or on the device app list page .

# Deploy on all devices of a project

  • On the project details page make sure that no device is selected. Click on ︙ button and choose Deploy app on all devices action:

Click on Deploy App on All Devices

  • On the window that appears, you can optionally add/remove environment variables for this app.

  • Paste a public accessible URL to your app, and click on the Deploy button

TIP

If you have not yet an app on hand, you can test our Hello World test app, for that, use this public URL for ARMv6 devices, and this public URL for ARMv7 devices to deploy the version v0.1.

After few seconds, you will receive realtime messages about the status and progress of the app deployment on each device.

Deploy App on All Devices of a Project

Once the app deployed on at least one device of the project, you can see it listed on the project app list page .

# Deploy on a subset of devices of a project

WARNING

If you don't select any device, the deployment will concern all the devices of the current project.

  • Click on the ︙ button, and choose the Deploy app action

  • Optionally, remove/add environment variables this app needs to properly work

  • Paste a public accessible URL to your app, and click on the Deploy button

TIP

If you have not yet an app on hand, you can test our Hello World test app, for that, use this public URL for ARMv6 devices, and this public URL for ARMv7 devices to deploy the version v0.1.

Deploy App on Selected Devices

After few seconds, you will receive realtime messages about the status and progress of the app deployment on each device.

Once the app deployed on at least one device of the project, you can see it listed on the project app list page .

# Update IoT Apps

You can easily update an already deployed app to a newer version, for that you have three options:

# Update on a single device

Click on Update App on this Device

  • You will get the same window as in the first deploy step, however with the previous public URL pasted. Follow the same steps as in the first deploy process, and after few seconds, you will receive realtime messages about the status and progress of the app deployment on this device.

TIP

You can use the same public URL to deploy multiple versions of the same app. This is why for convenience, the previous public URL has been pasted to deployment field.

TIP

If you used our Hello World v0.1 test app on the first deploy, you can now use its v0.2 version to test update. Here is the public URL for ARMv6 devices, and the public URL for ARMv7 devices to deploy the version v0.1.

# Update on all devices of a project

Click on Update App on all Devices

  • You will get the same window as in the first deploy step, however with the previous public URL pasted. Follow the same steps as in the first deploy process, and after few seconds, you will receive realtime messages about the status and progress of the app deployment on devices of the project.

TIP

You can use the same public URL to deploy multiple versions of the same app. This is why for convenience, the previous public URL has been pasted to deployment field.

TIP

If you used our Hello World v0.1 test app on the first deploy, you can now use its v0.2 version to test update. Here is the public URL for ARMv6 devices, and the public URL for ARMv7 devices to deploy the version v0.1.

# Update on a subset of devices of a project

  • Navigate to the project app list page then click on the target app

  • Select the devices you want to update app on

  • Click on the ︙ button, then click on the Update app on selected devices button:

Click on Update App on Selected Devices

  • You will get the same window as in the first deploy step, however with the previous public URL pasted. Follow the same steps as in the first deploy process, and after few seconds, you will receive realtime messages about the status and progress of the app deployment on devices of the project.

TIP

You can use the same public URL to deploy multiple versions of the same app. This is why for convenience, the previous public URL has been pasted to deployment field.

TIP

If you used our Hello World v0.1 test app on the first deploy, you can now use its v0.2 version to test update. Here is the public URL for ARMv6 devices, and the public URL for ARMv7 devices to deploy the version v0.1.

# Rollback IoT Apps

If you deployed an IoT app, then discovered that it is buggy (on one or more devices), do not panic! You can easily rollback the app version, for that you have three options:

# Rollback on a single device

  • On the top of the device app details page , you can check what is the current version, and what is the previous version

  • Click on the ︙ button, and choose Rollback app on this device

Click on Rollback Device App

  • Confirm by clicking on the Rollback button on the confirmation window

  • After few seconds, you will receive realtime messages about the rollback process on the device

# Rollback on all devices of a project

Click on Rollback Project App

  • Confirm by clicking on the Rollback button on the confirmation window

  • After few seconds, you will receive realtime messages about the rollback process on the device

# Rollback on a subset of devices of a project

  • On the project app details page , select the devices you want to update app on

  • Click on the ︙ button, then click on the Rollback app on selected devices button:

Click on Rollback Selected Devices App

  • Confirm by clicking on the Rollback button on the confirmation window

  • After few seconds, you will receive realtime messages about the rollback process on the selected devices

# Start/Stop IoT Apps

You can either stop an (already running) app on all or some devices of a project, or on a single device:

  • To stop a running app on all devices of a project, navigate to the project app details page . Click on the ︙ button, then click on the Stop app on all devices:

Click on Stop App on allDevices

  • To start the app again, use the same menu, and click on Start app on all devices

  • To stop a running app on a single device, navigate to the device app details page

  • Click on the ︙ button, then click on Stop app on this device:

  • To start the app again, use the same menu, and click on Start app on this device

Click on Stop App on thisDevice

TIP

  • Starting an already running app will have the effect of restarting this app
  • When an app has been started, you don't need to start it again on the next reboot of the device, it will auto-start

# Disable IoT Apps

Disaling an IoT app is like stopping it, except that it will not restart the next time the device reboots. You can either disable an app on all, or some devices of a project, or on a single device:

Click on Disable App on thisProject

  • To disable an app on a single device, navigate to the device app details page . Click on the ︙ button, then click on Disable app on this device:

Click on Disable App on thisDevice

# Delete IoT Apps

You can either delete an app on all or some devices of a project, or on a single device:

Click on Delete App on thisProject

Click on Delete App on thisDevice

Have Questions?

We're always happy to help with IoT projects or other questions you might have! Check our documentation, contact our support team at support@ionoid.io, or our sales team sales@opendevices.io. You can also ask questions on our forums or open an issue on Github.

← IoT Apps →