Kiosk
How to Troubleshoot Network
Step-by-step troubleshooting for the Kiosk Offline alert — verify network settings, reconnect to grid, reseat or swap the ethernet cable, power cycle, and validate the network port.
📋 Overview
The Kiosk Offline alert appears on the Checkout Screen and in Staff Mode when the kiosk cannot reach Mashgin's servers. This is almost always caused by a network configuration issue, a loose Ethernet cable, or a failing port. Work through the steps below in order, re-running the Network Test after each one, until the alert clears.
🛠️ How to Troubleshoot
Step 1. Open Network Settings
Open Staff Mode and go to Manage > Network.
- 1 Ethernet — open to view or change the connection.
- 2 Test — run the Network Test.
Step 2. Check the Connection Settings
Open Ethernet, confirm the DHCP or Static IP settings are correct, then tap Save.
- 1 DHCP — automatic addressing (the default).
- 2 Static IP — switch here to enter a fixed IP, gateway, and DNS.
- 3 Save — applies the configuration (briefly disconnects the kiosk while it reconnects).
Step 3. Run a Network Test
Go to Manage > Network > Test and tap Run Tests.
- 1 Results banner — the overall pass/fail summary.
- 2 Local Network checks — link, IP, DHCP lease, gateway, and link stability.
If all checks pass, the alert clears from the Checkout screen. If any check fails, continue to Step 4.
For what each check verifies, see Understanding the Kiosk Network Test.
Step 4. Reconnect to Grid
Open Staff Mode and go to Support > Grid (Reconnect). The kiosk will try to renew its connection to Mashgin's servers.
- 1 Grid (Reconnect) — a green check means success; an orange X means it failed.
If it fails, continue to Step 5.
Step 5. Reseat the Ethernet Cable
Unplug the Ethernet cable from the back of the kiosk, wait a few seconds, then plug it back in. Re-run the Network Test (Manage > Network > Test). If the alert remains, continue to Step 6.
Step 6. Power Cycle the Kiosk
Follow the full power-cycle procedure in How do I power cycle the kiosk?. If the alert persists afterward, continue to Step 7.
Step 7. Try a New Cable & Check the Port
Plug a different, known-good CAT6 or CAT5E Ethernet cable into both the port and the back of the kiosk. If the Network Test still fails, the problem is likely the port itself or the upstream network.
For the site's firewall, VLAN, and port requirements, see Network Architecture Guide.
💡 Tips
Always run a Network Test after every change — it's the fastest way to confirm whether the fix worked before moving on.
If the same kiosk goes offline repeatedly even after a clean Step 1–7 pass, the issue is likely upstream (switch, VLAN, or firewall). Escalate with the requirements in Network Architecture Guide.
🔗 Related Articles
- Understanding the Kiosk Network Test — reference for interpreting your Network Test results.
- How do I power cycle the kiosk? — the next step if a network reset doesn't clear the alert.
- How do I resolve an unresponsive staff checkout screen? — an offline kiosk often presents as an unresponsive screen, so check this if the screen is also frozen.
Network Architecture Guide — the site network's firewall, VLAN, and port requirements, for upstream escalations.
Need help? Contact support at 📧 help@mashgin.com or call (855) 475-0889
