This tutorial assumes that you have already downloaded Roombelt and applied a license as documented on this page.
Roombelt uses Microsoft Graph to authenticate users and access their calendars. You need to create an application on Microsoft Azure. This way you can be sure that nobody outside of your company has access to your private data.
Create new app using the New registration button. For Supported account types choose Accounts in any organizational directory. Keep Redirect URI empty and click Register.
For the new application go to the Authentication page and add two Redirect URIs of type Web:
Go to the Certificates & secrets page and click button New client secret. Choose Never as an expiration time. Store the created secret somewhere - you will need it in a moment.
In the API permissions tab add two Microsoft Graph application permissions: Calendars.ReadWrite and User.Read.All.
Go to the Overview page and find Application (client) ID. You will need it in a moment.
Modify the file
roombelt.env with the following content:
OFFICE365_CLIENT_ID=<APPLICATION (CLIENT) ID OF YOUR AZURE APP>OFFICE365_CLIENT_SECRET=<SECRET OF YOUR AZURE APP>OFFICE365_REDIRECT_URL=http://localhost:3000/office365/oauth_callbackOFFICE365_REDIRECT_URL_ADMIN=http://localhost:3000/office365/oauth_callback_admin
Next, run Roombelt with one of the following commands:
roombelt.exe - on Windows./roombelt - on Linux
Roombelt should be available at
For production usage you should setup a PostreSQL database and configure HTTPS certificate. These topics will be covered in this documentation soon. Consider using the Cloud version if you have little experience with securing and provisioning web applications.