Troubleshooting

The problems owners ask about most, and what to do. Still stuck? WhatsApp +237 679 690 703.

On this page

Printing

Receipts don’t print

  1. On Windows, open Settings, Printers & scanners, and check the printer is not Offline and has no stuck jobs. Turn it off and on.
  2. In Business settings, Receipt, check the Printer and the Paper width (58 or 80 mm), then press Print test receipt.
  3. In a browser, receipts open the print dialog: pick the receipt printer and set margins to none.

The receipt is cut on the right

Choose the right paper width (58 mm rolls print 48 mm wide). LoungeOS prints exactly the printer’s width from the left edge.

The cash drawer does not open

The drawer must be plugged into the receipt printer, and the printer on. Test with Open the drawer now in Business settings, Receipt.

Signing in

Someone forgot their till PIN

A manager opens Staff, edits the person and types a new Till PIN. The owner can set their own in My settings online, and use Forgot password? on the till.

The till asks to sign in again

The till was signed out of the account (for example from Devices in your account). Press Sign in with my account and confirm the code.

Sync

The till says Offline but the internet works

Press the cloud icon, then Sync now. If it stays offline, restart LoungeOS. Check that the computer’s date and time are right.

Sales from the till are missing online

They are still on the till, waiting to sync: the cloud icon shows how many changes are not sent yet. They arrive as soon as the till is online.

Installing

Windows says it protected my PC

Press More info, then Run anyway. The installer comes from loungeos.app.

macOS says LoungeOS cannot be opened

Open System Settings, Privacy & Security, and press Open Anyway. Check you took the right download: Apple Silicon (M1 and later) or Intel.

Android blocks the installation

Allow installs from your browser or your files app when Android asks, then open the APK again.

Kitchen and bar

Drinks show on the kitchen screen

The drink’s category is set to Kitchen. Open Menu, Categories, edit it and choose Bar.

An order does not appear on the kitchen screen

Check it was sent (Place Order or Send changes): items not yet sent are not on any screen.

Plans

A page shows a lock

Your plan does not include that feature. Press Upgrade to unlock, or see Plans and billing.

LoungeOS is read-only

Either the subscription ended (pay in your account and it opens within a minute), or a till has not synced for 7 days (connect it to the internet once).

Contact support

  • WhatsApp or call: +237 679 690 703
  • Email: support@loungeos.app
  • In the app: Help, Support to open a ticket.

Say which page you are on and what you pressed. A screenshot helps.

Stuck on a step? Write to support@loungeos.app or WhatsApp +237 679 690 703 and say which page you are on.

← All help articles