This is an old revision of the document!


Comulocity application

  • You will need Node.js (6.7 or newer)
  • You will need npm (installed with Node.js)
  • You will need access to your Cumulocity account, i.e. you need your tenant name, username and password.

Install Node.js and npm

First download node.js: https://nodejs.org/dist/v7.3.0/node-v7.3.0-linux-x64.tar.gz

Then go to the download folder and unpack node.js.

tar –xzvf node-v7.3.0-linux-x64.tar.gz

Now we have to create a new folder for node.js.

mkdir /usr/local/node

Then we move all to the new folder.

mv node-v7.3.0-linux-x64/* /usr/local/node

At last we go to the root folder with cd and add the path of node.js.

export PATH=$PATH:/usr/local/node/bin

With echo $PATH we can see the paths.

Command line interface

Now we go to the /usr/local/node folder and install the comulocity-tools.

npm i cumulocity-tools –g

After this we can check the installation and we see the command what we can use to build our Cumulocity apps.

c8y --help

Installing Cumulocity UI plugins

Now the can create a folder for our Cumulocity app. In this folder we need a package.json file. This file we can create with:

npm init

We need for our app the Cumulocity UI plugins. In this folder are all the Cumulocity plugins. If we want, we can use this in our app.

c8y install latest

If you want, to see in detail how you can create your app then klick on this link: https://www.cumulocity.com/guides/web/introduction/

If you are finished with your app, then you can build your app and upload to Cumulocity. To build the app go to the root folder of your app:

c8y build:app

The app is stored in /build folder of your app.