---
myst:
  html_meta:
    "description lang=en": "Administrative functions for the Per-Workspace Progressive Web App (PWA) feature in Kasm Workspaces."
    "keywords": "Kasm, Workspaces, PWA, Progressive Web App"
    "property=og:locale": "en_US"
---
```{title} Per Workspace PWA Administration
```

# Progressive Web App (PWA)

Workspaces supports being installed as a PWA. This gives users a better user experience, especially on mobile devices.

## Requirements

### Group setting

In order to give users the option to install the per-workspace PWAs, the **control_panel.pwa_install_option** group setting must be enabled. Go to Access Management -> Groups -> Select the group and click edit -> Settings -> Add Setting -> Add the "control_panel.pwa_install_option" and set the value to "True".

```{figure} /images/groups/add_pwa_group_setting.png
:align: center
**Set control_panel.pwa_install_option to True**
```

### Secure connection

In order for workspaces to show as an installable PWA it must be served from a secure HTTPS connection and with trusted certificates.

### Valid installed JSON manifest

Kasm workspaces provides a working manifest, if you want to make changes for branding then you can swap out the icons found in the manifest.

* `img/favicon.png`

### Icons

In order for an icon to be used, it must be square with an exact 1:1 ratio. If the image type is an svg, then the svg should also specify height and width attributes in the source. If it isn't, the PWA can still be installed, it just wont use the image for the app icon.

```{figure} /images/user_guide/svg_size.webp
:align: center
**Icons must be square**
```

### Installed service worker

Kasm Workspaces provides a service worker in order for the PWA to be installable. However, Workspaces requires an active internet connection in order for it to be useful, so at the present time the service worker is only used for detecting if the app is online.