If you need help with configuring Roombelt just to go to roombelt.com and ask for help using the chat widget.

Prerequsites

Roombelt is a Node.js application. We recommend installing Node.js 8.11.2 or newer with npm 5.6.0 or newer. You can download them from this website.

Roombelt uses Google API to authenticate users and access their calendars. You need to create your own project on Google Cloud Platform. This way you can be sure that nobody outside of your company will have access to your private data.

Create and configure project on Google Cloud Platform

  1. Create new project using the Create Project button.

  2. In the new project go to API Library and enable the following API-s

    • Google Calendar API

    • Google+ API

  3. Go to OAuth consent screen and set Product name shown to users to value Roombelt

  4. Go to Credentials and click Create Credentials -> OAuth client ID

    • Choose Application type to value Web application

    • Set Authorized redirect URIs to http://localhost:3000/api/oauth/callback

    • Click Save

    • Save Client ID and Client secret somewhere - you will need them in a moment

Install and configure Roombelt

Download Roombelt source code from this page. Extract the zip file and in the extracted directory create a file called roombelt.env with the following content:

GOOGLE_CLIENT_ID=<CLIENT ID OF YOUR GOOGLE APP>
GOOGLE_CLIENT_SECRET=<CLIENT SECRET OF YOUR GOOGLE APP>
GOOGLE_REDIRECT_URL=http://localhost:3000/api/oauth/callback
DATABASE_URL=sqlite:roombelt.sqlite

Run the app

Run the following commands in the directory with file roombelt.env .

$ npm i
$ npm run build:frontend
$ npm start

Roombelt should be available athttp://localhost:3000.