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

# Troubleshoot Kiosks

> Get a GoGuardian Visitor kiosk working again when it's offline, says it isn't ready, or shows an error: what front office staff can fix at the desk, and what IT checks next.

When a kiosk stops working, keep checking visitors and students in from the **Front Desk**, then try the fixes below. If they don't work, this page tells you when to call IT and what to tell them. The last section is for IT.

For help with a single visitor or student at a working kiosk, such as an ID that won't scan or a kiosk stuck on "Please wait," see [Help Visitors and Students at the Kiosk](https://docs.goguardian.com/products/visitor/kiosk-check-in-experience.md#help-visitors-and-students-at-the-kiosk). For badges that don't print, see [Troubleshoot Badge Printing](https://docs.goguardian.com/products/visitor/troubleshoot-badge-printing.md).

## Keep Checking In from the Front Desk

A kiosk that's down doesn't stop check-ins. Everything a kiosk does, staff can do from the **Front Desk**: check visitors in and out, complete pickups, check students in and out, and print badges. See [Use the Front Desk](https://docs.goguardian.com/products/visitor/front-desk.md).

While you work on the kiosk, ask visitors and students to come to the counter, and check them in from the **Front Desk** with the same forms. Those check-ins are recorded like any kiosk check-in.

## Get a Kiosk Working Again

Find what the kiosk or its **Front Desk** card shows below, and try that fix. If the kiosk still isn't working after the fix and a restart, stop and tell IT. See [Tell IT What's Wrong](#tell-it-whats-wrong).

Some fixes need a Site Admin. Each one says so.

### Wake an Offline Kiosk

On the **Front Desk**, the kiosk's card under **Kiosks** shows **Offline**. The kiosk may be off, asleep, signed out, or not connected to the internet.

1. Go to the kiosk and tap the screen. If it's dark, press the power button.
2. If the device is off or the battery is empty, plug it in and turn it on.
3. Check what the kiosk shows:
   * **Its welcome screen:** Restart it. See [Restart the Kiosk](#restart-the-kiosk).
   * **Kiosk Login:** See [Sign the Kiosk Back In](#sign-the-kiosk-back-in).
   * **"Connection Lost":** See [Reconnect After "Connection Lost"](#reconnect-after-connection-lost).
   * **"Error":** See [Start Over After an Error](#start-over-after-an-error).
4. Verify the result: Within a minute, the kiosk's card on the **Front Desk** shows **Inactive**, which means it's online and ready, or **Active** if a check-in picked up where it left off.

If the kiosk keeps going to sleep or going offline, tell IT.

![Front Desk Kiosks card with the offline Gym Entrance Kiosk highlighted next to an Active kiosk](https://mintcdn.com/goguardian/vbbcOHBdrxzrcZoi/images/screenshots/troubleshoot-kiosks/03-kiosk-offline.png?fit=max\&auto=format\&n=vbbcOHBdrxzrcZoi\&q=85\&s=43f70f1580cd79bdf0ec7a5072b9d0a0)

### Clear "This Kiosk Isn't Ready"

The kiosk shows **This Kiosk Isn't Ready** with a card for each thing it's missing. The kiosk can't take check-ins until every card is cleared.

| Card | What it means | What to do at the desk |
| - | - | - |
| **Badge Printer Not Connected** | The kiosk's forms print badges, but the kiosk has no printer. | A Site Admin can tap **Open Kiosk Settings**, select their name in **Your User**, enter their PIN, select a printer under **Printer Settings**, and tap **Save Changes**. Otherwise, tell IT. |
| **Camera Access Required** | The kiosk isn't allowed to use the camera, which it needs for ID scans, photos, and badges. | Tap **View Instructions** and follow the steps on screen. If the kiosk is locked to the app and you can't open the device's settings, tell IT the kiosk's name and which card it shows. |
| **Local Network Access Required** | An iPad kiosk isn't allowed to find the badge printer on the network. | Tap **View Instructions** and follow the steps on screen. If the iPad is locked to the app and you can't open **Settings**, tell IT the kiosk's name and which card it shows. |

After you fix a card, tap **Try Again**. When every card is cleared, the kiosk shows "All Issues Resolved" and returns to its welcome screen after 5 seconds. Tap **Go Home** to return right away.

![Kiosk This Kiosk Isn't Ready screen with Badge Printer Not Connected and Open Kiosk Settings, Camera Access Required and View Instructions, and Try Again](https://mintcdn.com/goguardian/vbbcOHBdrxzrcZoi/images/screenshots/troubleshoot-kiosks/01-kiosk-not-ready.png?fit=max\&auto=format\&n=vbbcOHBdrxzrcZoi\&q=85\&s=1b99a20466fb33e83ee103421a863fa7)

### Sign the Kiosk Back In

The kiosk shows **Kiosk Login** instead of its welcome screen. A staff member signed it out, or its login changed.

Signing in needs the kiosk's username and password, which only a Site Admin can see. Ask a Site Admin to sign it in, or tell IT. See [Sign In on the Kiosk Device](https://docs.goguardian.com/products/visitor/kiosks.md#sign-in-on-the-kiosk-device).

### Reconnect After "Connection Lost"

The kiosk shows "Connection Lost" and "Check your internet connection. We'll reconnect automatically when you're back online." This screen appears only on iPad and Windows kiosks.

1. Wait a moment. The kiosk keeps trying on its own.
2. To try right away, tap **Reconnect Now**.
3. Verify the result: The kiosk shows its welcome screen.

If the kiosk is still disconnected after a few minutes, check whether the **Front Desk** loads on your computer. Either way, tell IT. If the **Front Desk** doesn't load either, the school's internet may be down.

If "Connection Lost" changes to "Starting over in" with a countdown, the kiosk is reloading itself. Wait for the countdown to finish.

### Start Over After an Error

The kiosk shows "Error" and "An unexpected error occurred while processing your request." This often means the kiosk lost its connection partway through a check-in.

1. If the screen shows a **Request ID**, take a photo of the screen. IT needs the ID.
2. Tap **Start Over**.
3. Verify the result: The kiosk shows its welcome screen, or the step where a visitor or student left off.

On iPad and Windows kiosks, the screen may show "Starting over in" with a countdown instead, and the kiosk restarts on its own. If the error comes back, tell IT.

### Retry a Step That Won't Save

When GoGuardian Visitor can't save a step, the kiosk shows "Could not save your information. Please try again or ask a staff member for help." Ask the visitor or student to tap the button again. If it keeps failing, check them in from the **Front Desk** and tell IT.

### Restart the Kiosk

If the kiosk freezes, stops responding to taps, or seems stuck in a way the fixes above don't cover, restart it. The kiosk stays signed in, so you don't need its username and password.

1. Close the kiosk's browser tab or the GoGuardian Campus app, and open it again. If you can't close it, turn the device off and on with its power button.
2. Verify the result: The kiosk opens without asking you to sign in, and its card on the **Front Desk** shows **Inactive**, or **Active** if a check-in picked up where it left off.

If a visitor or student was partway through, the kiosk opens on the step where they left off, as long as it's within 30 minutes of their last step. If they've left, clear the check-in from the **Front Desk**: click **Edit Check-In** (or **Edit Check-Out**) on the kiosk's card, click **Cancel Check-in**, then confirm. The kiosk returns to its welcome screen.

If you need to restart the kiosk often, tell IT.

## Tell IT What's Wrong

Call IT when a fix doesn't work, the same problem comes back, or the fix needs access you don't have. At a minimum, tell them which kiosk, what it shows, and what the **Front Desk** shows:

* **Which kiosk:** The kiosk's name, as shown on its **Front Desk** card, and its check-in point.
* **What the kiosk shows:** The exact message, such as **This Kiosk Isn't Ready** with **Camera Access Required**, "Connection Lost," or **Kiosk Login**. A photo of the screen helps.
* **What the Front Desk shows:** **Offline**, **Inactive**, or **Active** on the kiosk's card.
* **When it started:** The time, and whether it has happened before.
* **What you tried:** Such as waking it, tapping **Try Again**, tapping **Reconnect Now**, or restarting it.
* **The Request ID:** If an error screen showed one.

Let them know you're checking visitors and students in from the **Front Desk** in the meantime.

## Fix Kiosk Problems as IT

These fixes need access to the kiosk device, your device management tools, or the Site Admin role in Visitor. Start from what front office staff report:

| Staff report | Go to |
| - | - |
| **Offline**, a dark screen, or **Kiosk Login** | [Bring an Offline Kiosk Back Online](#bring-an-offline-kiosk-back-online) |
| **This Kiosk Isn't Ready** | [Clear "This Kiosk Isn't Ready" for Good](#clear-this-kiosk-isnt-ready-for-good) |
| "Connection Lost," "Error," or frequent restarts | [Fix Connection Problems](#fix-connection-problems) |
| An error with a **Request ID** that keeps coming back | [Contact GoGuardian Support](#contact-goguardian-support) |

### Find the Kiosk and Its Device

1. In Visitor, go to **Check-In Points**, open the check-in point, and click the kiosk.
2. Check the badge next to the kiosk's name. **Online** means the kiosk is signed in and connected right now. Use this to confirm the kiosk's connection.
3. Under **Device**, use the **Device Name**, **Serial Number**, **Asset Tag**, or IP and MAC addresses to find the device in your device management tools. The kiosk shows only the details its device reports.

If the kiosk's page says "No device is signed in to this kiosk," sign in on the device. See [Sign In on the Kiosk Device](https://docs.goguardian.com/products/visitor/kiosks.md#sign-in-on-the-kiosk-device).

![Front Office Kiosk page with the Online badge, Kiosk Login, Settings, and Device details for a fictional Chromebook: Device Name, Operating System, Serial Number, Asset Tag, and Device ID](https://mintcdn.com/goguardian/vbbcOHBdrxzrcZoi/images/screenshots/troubleshoot-kiosks/02-kiosk-device.png?fit=max\&auto=format\&n=vbbcOHBdrxzrcZoi\&q=85\&s=881305aee0cadc1071871ebe916d8fc9)

### Bring an Offline Kiosk Back Online

A kiosk is **Online** while it's signed in and holding a real-time connection to GoGuardian Visitor. It shows **Offline** shortly after that connection drops. Check these in order:

1. **Sign-in.** Open the kiosk's page in Visitor to see why a device shows **Kiosk Login**:
   * **The kiosk isn't listed at the check-in point:** It was archived. Create a new kiosk for the device.
   * **The kiosk's page shows Create Kiosk Login:** A Site Admin revoked its login. Create a new one and sign in again. If you deploy the login as a Windows policy, deploy the new username and password. See [Revoke a Kiosk Login](https://docs.goguardian.com/products/visitor/kiosks.md#revoke-a-kiosk-login).
   * **The kiosk's page shows Online with a different Device Name:** The kiosk was signed in on another device with **Replace Kiosk**. A kiosk runs on 1 device at a time, so create a kiosk for each device.
   * **Otherwise:** A staff member signed it out. Sign in again. See [Sign In on the Kiosk Device](https://docs.goguardian.com/products/visitor/kiosks.md#sign-in-on-the-kiosk-device).
2. **Power and sleep.** If the kiosk keeps going to sleep, check the keep-awake settings for its platform: **Kiosk power settings** in the Google Admin console, **Auto-Lock** in Single App Mode on iPad, or the power settings on Windows. See [Set Up the Kiosk Device](https://docs.goguardian.com/products/visitor/kiosks.md#set-up-the-kiosk-device).
3. **Kiosk lock.** Make sure the device is locked to the kiosk, so visitors and students can't leave it. A closed browser tab or app shows **Offline**.
4. **Network.** Make sure the kiosk's network allows `https://*.goguardian.com` and `wss://ws-goguardian.pusher.com` on port 443. Without the second, the kiosk can load but never shows **Online**. See [Allow Network Traffic](https://docs.goguardian.com/products/visitor/compatibility-and-requirements.md#allow-network-traffic).
5. Verify the result: The kiosk's page shows **Online**, and its **Front Desk** card shows **Inactive**.

### Clear "This Kiosk Isn't Ready" for Good

The kiosk checks its camera and network permissions each time its welcome screen loads, and checks for a printer on its welcome screen.

**Badge Printer Not Connected:** The kiosk needs a printer when at least 1 of its forms has a **Print Badge** step with **Staff Print Only** off. Do one of these:

* Assign a printer on the kiosk: tap **Open Kiosk Settings** on the card, or tap **More** (⋮) and then **Edit Kiosk Settings**. Select your name in **Your User**, enter your PIN, select the printer under **Printer Settings**, and tap **Save Changes**. See [Add a Printer to a Kiosk](https://docs.goguardian.com/products/visitor/badge-printers.md#add-a-printer-to-a-kiosk).
* If badges should print at the front desk instead, turn on **Staff Print Only** in each form's **Print Badge** step. See [Let Staff Decide When Badges Print](https://docs.goguardian.com/products/visitor/badge-printers.md#let-staff-decide-when-badges-print).

The kiosk goes to this screen for a printer only when none is assigned. A printer that's assigned but off or disconnected doesn't stop check-ins, and the badge fails to print on the done screen instead. See [Troubleshoot Badge Printing](https://docs.goguardian.com/products/visitor/troubleshoot-badge-printing.md).

**Camera Access Required:** The kiosk shows this card when the camera is blocked or the device has no camera it can use.

* **iPad:** In **Settings**, find **Campus** and turn on **Camera**. When you set up each iPad, allow the camera when the GoGuardian Campus app asks.
* **Chromebook:** A Chromebook kiosk set up in the Google Admin console gets camera access automatically, with no prompt, for the kiosk app's own URL. If the card appears, check that the Chromebook has a working camera and that the kiosk app's URL is `https://campus.goguardian.com/kiosk`. See [Set Up a Chromebook Kiosk](https://docs.goguardian.com/products/visitor/kiosks.md#set-up-a-chromebook-kiosk).
* **Web browser:** Click the lock icon in the address bar, find **Camera**, and select **Allow**.
* **Windows:** The GoGuardian Campus app doesn't ask for camera access, so this card doesn't appear. If ID scans or photos don't work, check that the computer has a working camera.

**Local Network Access Required:** Only the GoGuardian Campus app on iPad asks for this. It needs local network access to find network badge printers. In **Settings**, find **Campus** and turn on **Local Network**.

After each fix, tap **Try Again** on the kiosk. Verify the result: The kiosk shows "All Issues Resolved," then its welcome screen, and its page in Visitor shows **Online**.

### Fix Connection Problems

**"Connection Lost":** The GoGuardian Campus app on iPad and Windows shows this when it can't load the kiosk. It retries on its own, waiting a little longer after each try, up to every 2 minutes.

1. Check that the device is on a network that reaches the internet.
2. Confirm that the network allows the traffic in [Allow Network Traffic](https://docs.goguardian.com/products/visitor/compatibility-and-requirements.md#allow-network-traffic).
3. Tap **Reconnect Now** on the kiosk.
4. Verify the result: The kiosk shows its welcome screen, and the kiosk's page shows **Online**.

**"Error" and "Starting over in":** A kiosk that loses its connection partway through a check-in shows the "Error" screen. On iPad and Windows, the GoGuardian Campus app also reloads a kiosk that hits an error or stops responding, and shows "Starting over in" with a countdown. If either happens often, check the network the same way, restart the device, and make sure the GoGuardian Campus app is up to date.

In a web browser or on a Chromebook, a kiosk that can't reach GoGuardian Visitor shows the "Error" screen.

### Contact GoGuardian Support

If the kiosk still doesn't work, contact [GoGuardian Support](https://support.goguardian.com/s/contactsupport). Include:

* The site, check-in point, and kiosk name
* The **Platform** and **Operating System** from the kiosk's page
* The exact message the kiosk shows, and a photo of the screen
* The **Request ID**, if an error screen showed one
* When the problem started and what you've tried

## Resources

* [Kiosks](https://docs.goguardian.com/products/visitor/kiosks.md)
* [The Kiosk Check-In Experience](https://docs.goguardian.com/products/visitor/kiosk-check-in-experience.md)
* [Use the Front Desk](https://docs.goguardian.com/products/visitor/front-desk.md)
* [Troubleshoot Badge Printing](https://docs.goguardian.com/products/visitor/troubleshoot-badge-printing.md)
* [Compatibility and Requirements](https://docs.goguardian.com/products/visitor/compatibility-and-requirements.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.