To run Roombelt you need Docker.
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.
Create new project using the Create Project button.
In the new project go to API Library and enable the following API-s
Google Calendar API
Google People API
Go to OAuth consent screen and set Product name shown to users to value Roombelt
Go to Credentials and click Create Credentials -> OAuth client ID
Choose Application type to value Web application
Set Authorized redirect URIs to
Store Client ID and Client secret somewhere - you will need them in a moment
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/google/oauth_callbackDATABASE_URL=sqlite:roombelt.sqliteFORCE_HTTPS=false
Run the following command in the directory with file
docker run -it --env-file=./roombelt.env -p 3000:3000 ziolko/roombelt
Roombelt should be available at
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.