> ## Documentation Index
> Fetch the complete documentation index at: https://docs.goguardian.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Up Hall Pass as a PWA in Kiosk Mode

> Deploy GoGuardian Hall Pass as a Progressive Web Application (PWA) in kiosk mode on managed ChromeOS devices using Google Admin Console.

This article covers PWA kiosk deployment on managed ChromeOS devices using Google Admin Console (GAC). Deploying Hall Pass as a PWA in kiosk mode locks a shared device to the Hall Pass interface, prevents students from navigating away, and keeps the app updated automatically.

## Before You Begin

Confirm the following before configuring anything in Google Admin Console:

* **ChromeOS devices**: Kiosk mode is native to ChromeOS.
* **Managed licenses**: Devices must be enrolled in your school's Google Workspace domain.
* **Dedicated Organizational Unit (OU)**: Create a specific OU (for example, "Hall Pass Kiosks") for these devices. This keeps the restrictive kiosk settings from applying to students' personal logins.

## Install Hall Pass as a PWA in Kiosk Mode

Instead of installing through a user's browser, you'll force-install the app at the device level.

1. Log in to the **Google Admin Console**.
2. Go to **Devices > Chrome > Apps & extensions > Kiosks**.
3. Select the OU you created on the left side.
4. Select the yellow **(+)** button in the bottom right, then select **Add by URL**.
5. Enter the Hall Pass application URL.
6. Under **Installation Policy**, set it to **Installed**.

## Configure Auto-Launch

Auto-launch ensures the device boots directly into Hall Pass without showing a login screen.

1. In the **Kiosks** menu, find the **Auto-launch app** dropdown at the top of the list.
2. Select your **Hall Pass app** from the list.
3. Select **Save** in the top right.

The next time the device reboots, it will skip the login screen and launch Hall Pass immediately in full-screen mode.

## Lock Down Device Settings

Configure the following settings in **Devices > Chrome > Settings > Device Settings** to prevent students from exiting the kiosk:

| Setting                | Value     | Purpose                                                                |
| ---------------------- | --------- | ---------------------------------------------------------------------- |
| **Kiosk Sleep Mode**   | No Action | Prevents the device from timing out or showing a lock screen.          |
| **System Info**        | Disabled  | Blocks Ctrl + Alt + I, which shows system stats.                       |
| **Screen Dimming**     | Never     | Keeps the Hall Pass interface visible at all times.                    |
| **Keyboard Shortcuts** | Restrict  | Disables common exit shortcuts, including Ctrl + Shift + Q (Sign out). |

## Prevent Back-Navigation

Since kiosk mode has no browser back button, configure these additional settings to prevent navigation out of Hall Pass:

1. In GAC, go to **User & Browser Settings**.
2. Search for **Overscroll history navigation**.
3. Set it to **Disabled**.
4. Verify the result: Students can no longer swipe to navigate back out of the app.

<Note>
  For standard Hall Pass kiosk deployment, the PWA method described in this article is the recommended approach. It supports Auto-launch and receives remote updates automatically. Isolated Web Apps (IWAs) are restricted to specific enterprise partners for high-security hardware access and aren't suitable for standard Hall Pass deployments.
</Note>