Development Tools and Tips


Utility Scripts

  • takes a directory and ip address then copies the entire directory to /media/card/ on the Conduit®. This can be used if you want to try manually installing and running your app without app-manager.
  • takes a directory and ip address. It tars up the app, copies it to /media/card/ on the Conduit, then uses app-manager to manually install the app (bypassing DeviceHQ).

Create the Tarball Package

$ cd <your_top_level_app_directory>
$ tar --hard-dereference -hczf <path_to_create_tgz>.tgz *

Manual Installation

  1. Copy the tarball package to /media/card/ (installation will fail if the archive is in the root file system)
    $ scp <your_tarball> admin@<your_conduit_ip>:/media/card/
  2. Install the app:
    $ app-manager --command local --apptype CUSTOM --appname <your_app_name> --appfile /media/card/<your_tarball>
  3. NOTE: You must uninstall a manually installed app before installing the same app through DeviceHQ:
    1. Via the Conduit UI’s Apps page
    2. Via the command line:
      $ app-manager --command remove --appid LOCAL

Starting and Stopping

  • Via the Conduit UI’s Apps page
  • Via the command line:
    $ app-manager --command start --appid LOCAL
    $ app-manager --command restart --appid LOCAL
    $ app-manager --command stop --appid LOCAL

Check App Status

  • Via the Conduit UI’s Apps page:
    • Shows the name, version, status, and info fields for all installed apps.
    • To see description, hover mouse over the app name.
    • To see version notes, hover over the version.
  • Via the command line:
    $ app-manager --command status


For information on deploying apps to production, see Production Deployment.