Skip to main content
Skip table of contents

Example: Microsoft Outlook as a Progressive Web App (PWA) on IGEL OS 12

This article describes setting up a Progressive Web App (PWA) on IGEL OS 12. We will use Microsoft Outlook as an example; for other web apps, the procedure is similar.

Basically, a PWA is an instance of Chromium with a specific profile in the so-called app mode. All policies that are defined for Chromium are also valid for the PWAs, except for the Clear data setting, which is only available for PWAs.

Prerequisites

  • Device with IGEL OS 12.

  • The app “Progressive Web App” is installed on your device

  • You know the PublisherID of your Progressive Web App. You can retrieve it by installing the PWA on any device, no matter which OS, by entering chrome://app-service-internals, and scrolling to the entry PublisherID of the app in question. For this purpose, you can use Chrome, Chromium, Edge, or any other Chrome-based web browser; you may have to replace chrome with the actual browser name, e.g.edge://app-service-internals. Please note that Progressive Web Apps on IGEL OS always use Chromium.

Creating a Session

  1. In the profile configurator, go to Apps > Progressive Web App > Sessions and add a new session.

image-20241211-160838.png

  1. Enter a Session name, for instance, “Outlook”.

image-20241211-161421.png

  1. Go to Settings and enter the Progressive Web App Url. This is the PublisherID you discovered via <BROWSER NAME>://app-service-internals (e.g.chrome://app-service-internals). For Microsoft Outlook, the correct value is https://outlook.office365.com/mail/

image-20241211-161806.png

  1. Optional: If you want to use an alternative icon, enter the path to the image file under Progressive Web App Icon (optional). This will override any auto-detected icons coming from the PWA itself

image-20241211-161840.png

  1. Save your changes and send them to the device.

image-20241211-161945.png
image-20241211-075536.png

On the device, after a timeout dialog, a message window informs the user that the Progressive Web App has been created.

image-20241212-113609.png

Completing the Installation of the PWA

  1. Click on the newly added icon.

image-20241212-113710.png

The app is shown in a regular browser window.

image-20241212-132316.png

  1. When the message window requests a reboot, reboot your device.

image-20241212-130607.png
image-20241212-130748.png

After the reboot, the Microsoft Outlook PWA is available.

image-20241212-133004.png

Troubleshooting: Reinstalling the App if Something Went Wrong

If the Progressive Web App does not work as expected, e.g. the starter icon does not appear, it is recommended to reinstall it.

To reinstall a PWA:

  1. Start the PWA (or any other PWA).

  1. While the PWA window is open, remove the session.

image-20241212-111446.png

  1. Wait for about 1 minute.

  1. Install the PWA again as described under Creating a Session and Completing the Installation of the PWA.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.