Troubleshooting
| Symptom | Likely cause | Fix |
|---|---|---|
| Receipt won't print | Wrong printer IP/port, printer off, or setting changed without restart | Check the printer host/port in Settings, power-cycle the printer, restart the app |
| "Printing not available" | Web terminal, or iOS in this release | Use a desktop or Android terminal for printing |
| Sync badge stuck on "Queue N" (red) | No connection, or parked/failed items | Restore the connection; the queue drains automatically. Persistent red = items were rejected — check with a manager |
| Can't send to kitchen / "needs connection" | Offline | Kitchen sends, 86'ing, and wastage need a connection; take ring-and-pay orders until it's back |
| The green "ready to run" banner never appears | Browser terminal (no live push), or the viewer is on the Kitchen tab | Use a desktop/Android/iOS terminal for runners; the KDS itself always shows READY |
| Browser till lost its cart/data after refresh | Browser terminals don't persist local data | Expected — use desktop or Android/iOS devices as real tills |
| "Seeding demo data…" on first launch | First-run setup | Wait for it to finish; don't force-quit |
| Can't sign in | Wrong PIN, or deactivated staffer | Re-check the PIN (4–8 digits); a manager can reset it in Back Office → People |
| Back Office "session expired" | Login timed out | Sign in again — no work is lost |
| KDS shows nothing | Offline, or a station filter is set | Check the connection; tap All to clear the station filter |
| Gift card / house account tender fails | Offline, empty balance, or credit limit reached | These tenders verify server-side — reconnect, check the balance in Back Office |
| Payment provider error (502) | Provider outage or bad keys | Retry; take cash/another method; escalate to the installer |
| QR menu won't load | Wrong/edited link, or location offline | Confirm the QR points at the right loc and table; reprint from Back Office → Tables |
| QR item photos don't show (emoji instead) | The image host blocks cross-site loading (CORS) | Host product images somewhere that allows embedding, or keep the emoji |
| Kiosk runs but looks like a narrow phone column | Link uses kiosk=true | Use kiosk=1 in the kiosk URL |
| Guest booking says "that time just filled up" | Pacing/covers cap reached for the slot | Expected — adjust availability schedules if it's too strict |
| Table shows available but has guests | Rare sync race | Refresh Floor; a manager can re-seat/clear the table |
More in Troubleshooting and reference
All collections →Still stuck? Mail support@aurapos.co.za or use the support page — include your venue name and what you were doing.