Updating Evoko Home to v2.8

Why Should I Update?

Microsoft has retired the use of RBAC Application Impersonation in Exchange Online. Previous versions of the Evoko Home App used Application Impersonation for syncing Calendar events between Microsoft 365 and Evoko Home. As such, these previous versions will no longer function.

Complete the new App Registration with Microsoft Graph

This process must be followed for Evoko Home v2.8 to sync with Microsoft 365.

1. Log into the Microsoft Entra Admin Center with your Microsoft Admin Account.
2. Navigate to the Applications, then App Registrations. Select All applications, and search for your organization's existing Evoko Home app.
3. Click on the application to bring up the summary page. Make a note of the Azure AD Application (Client) ID and Azure AD Directory (Tenant) ID.

Once you have retrieved this information, continue with Microsoft 365 app registration, starting at Step 6 (configuring the Client Secret).

Keep in mind, we strongly recommend you creating a new app registration for Graph API (not editing the old app registration, that causes some issue)

Install Evoko Home v2.8

It is strongly recommended to back up the Evoko Home configuration before proceeding with this update. To do so:

1. Sign into the Evoko Home app by navigating to http://localhost:3000 in your browser (it will redirect to https://localhost:3002).
2. Click Global Settings in the navigation bar.
3. Scroll down to Backup. Enter and re-enter an Encryption secret, then click Backup.
4. Click the link under "Download the latest backup" and save the file in a safe location.

The option to back up Evoko Home was introduced in v2.7.4.8. For previous versions, it is recommended to create a system image backup.

After creating the backup, follow the steps for Installing on Windows Server or Installing on Ubuntu 22.04 LTS, depending on your platform.

Perform the API Migration in Evoko Home v2.8

Once the update is installed, you will need to reconfigure Evoko Home to authenticate using Microsoft Graph rather than OAuth.

1. Sign into the Evoko Home app by navigating to http://localhost:3000 in your browser (it will redirect to https://localhost:3002).
2. Click Global Settings in the navigation bar.
3. Scroll down to API Migration for Booking System. Click Migrate.
4. Enter the Azure AD Application (Client) ID, Azure AD Client Secret Value, and the service account used for email sending in Evoko Home. Click Migrate.
5. A pop-up warning will appear. Click Confirm.
6. Once the "Migration successful" message appears, the migration is complete.