Getting started

Introduction

CDAPP is a free, open source application that helps automate workflows which take input data such as CSV files and perform conditional actions based on the data of each row. For more information, see About CDAPP.

This guide assumes you want install the user version of the application, and not the developer version.
If you wish to contribute to the project then check out this page.

Note: this project has not been tested in a Linux or Mac environment, only Windows.
If you encounter any bugs, please submit them as an issue.

Part 1: Installing

If you do not already have a node environment configured, head over to download page and install the latest version (including npm).

CDAPP was created on node version 18 but will likely work on newer versions.

Clone or download the main branch of the repository and using terminal in the root folder run:

$ npm install

You can use the install-service.bat script to install the app as a windows service. Customise service.xml as required.

If you want to serve the application and access it from another device, then you will likely need to allow port 2328 through your firewall.

Part 2: Running and Configuring

If you installed as a windows service, start the service via windows services mmc, or run start-service.bat. Otherwise standard node enviornment rules apply - run:

$ npm start
or
$ node server.js

In your preferred web-browser, navigate to http://localhost:2328 (replacing localhost with the IP of the service if accessing remotely). You will be presented with the first run page used to configure the administrator account:

Configure the username and password for the initial administrator / default account to login to the service to be presented with the dashboard:

The CDAPP application is now configured and ready for use. General application settings can be found on the settings tab under dashboard.

Next up, learn how to create an application schema.