Prerequsites

To run Roombelt you need Docker.

Create and configure project on Google Cloud Platform

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

  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

Configure and quick start

Create a file 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 following command in the directory with file roombelt.env .

docker run -it --env-file=./roombelt.env -p 3000:3000 ziolko/roombelt

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

Production setup

For production usage you should setup a PostreSQL database and configure HTTPS certificate. Consider using the Cloud version if you have little experience with securing and provisioning web applications.