Overview
This guide is for local administrators: the people on site who look after FUYL Smart Lockers day to day. It lists the problems seen most often at the locker, what usually causes each one, and where to fix it.
It covers FUYL Enhanced lockers managed with the FUYL Kiosk and the FUYL Portal (FUYL.io), including FUYL Tower MK2.5, FUYL 5 Pro and FUYL 15 Pro (MK3), and FUYL 8 and FUYL 23 (MK4).
Fixes happen in one of three places:
- Kiosk: the Admin menu on the FUYL Kiosk. Tap the cog in the bottom right and sign in as an administrator. View tower shows every bay, its workflow and its state.
- Portal: the FUYL Portal at FUYL.io, e.g. the Stations and Loans pages, workflow settings and users.
- Locker: physical checks on the locker itself, such as power, network cables and locks.
Note: some Kiosk and Portal options depend on the role assigned in the FUYL Portal. The Technician role is enough for everything in this guide: loading and collecting devices, opening bays and restarting lockers.
Start here
- Note the time and take a photo Write down the exact time, the screen or message shown, the bay and the user. Support uses these to find the event in the logs, so it's worth doing before trying any fixes.
- Check the Kiosk app is up to date The version is shown in the bottom left of the Kiosk Admin menu. Compare it with the FUYL Kiosk app in the App Store. An out-of-date app is the most common cause of sign-in problems, "Something went wrong" and devices showing in the wrong place. If the iPad is managed by an MDM, check the MDM allows the app to update.
- Check the iPad's date and time In the iPad's Settings, under General > Date & Time, turn on Set Automatically. A wrong time zone causes errors and wrong due dates.
- Check View tower It shows which bays are allocated, occupied, flagged or offline, and it's the first thing support asks for.
Restart in this order
Many problems clear with a restart. Work through these in order, checking whether the problem has cleared after each one.
- Close and reopen the Kiosk app Swipe up from the bottom of the screen and swipe the app away, then open it again. If the iPad is locked to the app (single app mode), restart the iPad instead.
- Restart the iPad Hold a volume button and the top button, then slide to power off.
- Restart the locker from the Portal Find the locker on the Stations page and restart it. If the restart fails, go to the next step.
- Switch the locker off at the wall Leave it off for at least 30 seconds, then switch it back on. This restarts the locks as well as the control door, and clears problems a remote restart doesn't.
Locker and network
| What you see | Likely cause | What to do |
|---|---|---|
| Every bay light is red, and the locker shows Offline | The locker has lost its connection to the FUYL Portal, usually because of a network change (firewall, content filtering, SSL inspection or Wi-Fi settings). | Locker: check the network cable, or the Wi-Fi. Then switch the locker off at the wall and back on. If it stays offline, ask the network team whether anything has changed, and check the network still meets the FUYL Networking Requirements. |
| The locker shows Pending in the Portal, but works at the Kiosk | The locker's network settings conflict, often from settings applied before it was set up with the Kiosk. | Portal: open the locker's ⋮ menu, select Update network settings, and switch it to static and back (or the other way). It's safe to leave in the short term. |
| The locker is offline and nobody noticed | There's no alert by default. | Portal: set up an automation that alerts you when the locker becomes inoperational. See Automations. |
| The Kiosk can't find or connect to the locker | The iPad has lost Wi-Fi, Bluetooth is off for the app, or the iPad is too far from the locker. | Check the iPad's Wi-Fi (turn it off and on again) and Bluetooth permission for the FUYL Kiosk app, then restart in order. See Troubleshooting Bluetooth. |
| The locker's display is dim or blank, or the bay lights are all different colours or cycling | Usually a fault in the control door, occasionally its SD card. | Switch the locker off at the wall and back on. If it doesn't clear, contact support with a photo of the display and lights. A restart doesn't usually fix this. |
Kiosk and sign-in
| What you see | Likely cause | What to do |
|---|---|---|
| "Something went wrong" | Most often an out-of-date Kiosk app or the wrong time zone on the iPad. Less often a problem on the platform. | Work through Start here, then restart in order. If it happens again, contact support with the time, the screen and the user. |
| A user can't sign in: "Not authorised", "ID does not exist", or back to the start screen | The user isn't provisioned or isn't in the right group, their ID doesn't match (IDs are case-sensitive), or their account is missing a required field such as a first name. An out-of-date Kiosk app causes this too. | Check the Kiosk app is up to date. Portal: check the user exists under Users and is in a group linked to the workflow. If not, pass the username and exact message to the IT team who manage provisioning. New or changed users appear after the next sync. |
| A card isn't recognised | The card value doesn't match the user's RFID credential, or the reader isn't set up for that card type. | Portal: run a test read under Settings > RFID . See Set Up RFID in the FUYL Portal. |
| A barcode doesn't scan | The barcode is too small or crowded, the iPad isn't held steady, or the barcode doesn't hold the value FUYL expects. | Print the barcode larger with a clear white border, and turn on Rotation Lock on the iPad. If it scans but isn't recognised, check the value matches the user's or device's ID. Typing the ID is a workaround. |
| The Kiosk is frozen, or very slow | The app or the iPad has hung, or the iPad or locker has a poor connection. | Restart in order. If it's stuck on an iOS or MDM screen after an update, finish the update or ask IT to. |
| The Kiosk is stuck on "Collect your device and shut the door" (or similar) with every door shut | The locker didn't report the door closing, because the lock didn't register it or the locker briefly lost its connection. | Push every door firmly shut, then restart in order. Switching the locker off at the wall is often what clears it. Then check View tower to make sure each bay shows the right device. |
| Bays open by themselves, or several open one after another | Commands sent while the locker was unresponsive are all carried out once it recovers. | Close the bays, switch the locker off at the wall and back on, then check View tower. Contact support with the times, as this needs looking into. |
| An admin option is missing from the Admin menu | The admin's role doesn't include it. | Portal: ask an account owner to check the admin's role. |
Bays and doors
| What you see | Likely cause | What to do |
|---|---|---|
| "No devices available" or "No bays available", but there are devices or empty bays | Bays are flagged, offline or not allocated to that workflow, there are more devices than bays allocated, or the user is at the wrong locker. With Dynamic Bays, the locker also holds back bays it expects to need, e.g. for a repair being collected. | Kiosk: check View tower for flagged, offline or unallocated bays and clear them. Check the Kiosk app is up to date, then restart the locker. With Dynamic Bays, keep a buffer of empty bays (around 2 per 10). See Dynamic Bays. |
| A bay doesn't open | The door is caught or under pressure, the lock has lost contact with the locker, or the lock is faulty. | Press the door in firmly while opening it from Kiosk > View tower > Unlock bay, or from the Portal. Then restart in order. If one bay still doesn't open, contact support. If several don't, check the locker's power. See Accessing Bays as an Administrator. |
| A door doesn't lock, doesn't stay closed, or shows red once closed | The bay's manual release pin is stuck down, something is blocking the door, or the catch is faulty. | Clear the doorway. Locker: on FUYL Tower and Tower Pro, open the side access door and find the bay's release pin. If it's sunk in, wiggle it free and the door closes normally. Contact support for an end cap so it doesn't happen again. If that's not it, contact support with a short video. |
| The wrong bay opens, e.g. an empty bay or someone else's device | The bay records don't match what's in the bays, e.g. after a bay was opened with the manual release or a device was put back in a different bay. | Kiosk: check View tower against what's physically in each bay, and correct any that don't match by removing the device and loading it again. |
Note: only use the manual release in an emergency, e.g. when the locker has no power. The locker doesn't know a bay was opened this way, so its records stop matching what's in the bays. Afterwards, check View tower and correct any bays that don't match.
Devices and loans
| What you see | Likely cause | What to do |
|---|---|---|
| Amber light on a bay | A loan device was returned unplugged, or isn't in the bay. It's marked unavailable for loaning. | Kiosk: open View tower, select the marked bay and select Open Bay. Plug the device in, close the bay, then select Save at the bottom of View tower. If the device is missing, check the Loans page in the Portal for the last user. See Assisting with Device Loaning. |
| A device shows as unplugged, but it's plugged in and charging | Some devices don't report their connection correctly over USB-C, e.g. after a firmware (BIOS) change. Devices on the power outlet (GPO) or a power bank can't be detected. | Unplug the cable and plug it back in, then save in View tower. If one model does it often, check its firmware is up to date, or turn off Mark loan device unavailable if returned unplugged in the loan workflow. See FUYL USB-C Charging Compatibility. |
| A returned device is unavailable because the user reported it damaged | The device condition report marks reported devices unavailable until an admin checks them. The report is emailed to the addresses set in the workflow. | Check the device. Then either select Make device available again on the Loans page in the Portal (if it's back in its bay), or remove it in View tower and load it again on the Kiosk. |
| A return isn't recorded, or the bay shows empty with the device inside | The door was closed too early, the locker didn't register the return, or the Kiosk app is out of date. | Check the Kiosk app is up to date. Kiosk: open the bay from View tower, then remove and load the device again so the record matches. |
| A user can't return a device because it's "already" in the locker | The device is recorded in a bay, e.g. after a bay was opened with the manual release. | Portal: check the device's status and history on the Loans page. End the loan if needed, then correct the bay in View tower. |
| A device can't be deleted, or appears twice | The device ID was scanned with a hidden space at the end, by an older Kiosk app. | Update the Kiosk app on every iPad, then contact support with the device ID to remove the bad record. |
| Due dates land on a weekend, or at the wrong time | The iPad's time zone is wrong. | Turn on Set Automatically under General > Date & Time on the iPad, and check the time zone in the Portal's account settings. |
Bay light colours
| Light | What it usually means |
|---|---|
| White/Teal | The bay is empty and ready to use. |
| Amber | A loan device was returned unplugged, or is missing. See Devices and loans. |
| Red on one bay | The door is open. If it stays red once the door is shut, see Bays and doors. |
| Red on every bay | The locker is offline. See Locker and network. |
| Dim blue on every bay | No workflows are allocated, e.g. after a new setup or factory reset. See Allocating workflows to bays. |
| All different colours, or cycling | A fault in the control door. See Locker and network. |
Contact support
If the steps above don't fix it, raise a ticket and include:
- the locker's serial number (see Identify a Smart Locker), name and site
- the exact time, the screen or message shown, the bay and the user
- a screenshot of View tower, and the Kiosk app version
- what's already been tried
- photos or a short video of any lights or physical problem