Office365

Prerequsites

To run Roombelt you need Docker.

Create and configure application on Microsoft Azure

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.

  1. 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.

  2. For the new application go to the Authentication page and add two Redirect URIs of type Web:

    • http://localhost:3000/office365/oauth_callback

    • http://localhost:3000/office365/oauth_callback_admin

  3. 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.

  4. In the API permissions tab add two Microsoft Graph application permissions: Calendars.ReadWrite and User.Read.All.

  5. Go to the Overview page and find Application (client) ID. You will need it in a moment.

Configure and quick start

Create a 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_callback
OFFICE365_REDIRECT_URL_ADMIN=http://localhost:3000/office365/oauth_callback_admin
DATABASE_URL=sqlite:roombelt.sqlite
FORCE_HTTPS=false

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.