Guide · printer fix

macOS is blocking local network

macOS asks once whether EasyKOT may talk to devices on your network. If someone pressed Don't Allow at that moment, every printer looks dead from then on: the internet still works, sync still works, and only the packets that would reach your own shop's printers are dropped. It is one switch to turn back on.

Start free — ₹0 todayDemo on WhatsApp

Whatever the printer does, the sale is already saved: the Desktop App writes the bill to its own database first and queues the paper second. The full symptom table covers the rest.

Most likely cause

A privacy prompt was answered no, months ago, by whoever set the Mac up.

  • The Local Network prompt was refused. macOS asks each app once, with the reason the app supplies: EasyKOT's is “EasyKOT finds and prints to receipt and kitchen printers on your network, and links Desktop Apps in the same store.” A Don't Allow there is permanent until the switch is changed by hand.
  • It looks exactly like a dead printer. The refusal is enforced below the app: every connection to a local address fails as unreachable, so Detect finds nothing, a typed IP does nothing, and the printer sits there working perfectly. This is what makes it worth naming rather than leaving to elimination.
The fix

Do this first.

1

Open System Settings → Privacy & Security → Local Network

The Apple menu, then System Settings, then Privacy & Security in the sidebar, then Local Network. It is a plain list of every app that has asked, each with a switch.

2

Switch EasyKOT on

One toggle. macOS applies it immediately: there is no restart and no confirmation dialog. If EasyKOT is not in the list, quit and reopen the EasyKOT Desktop App so it attempts the network once, then look again.

3

Retry from the Desktop App

Press Test connection on the printer's row in Settings → Printers & KDS, or Retry now on a waiting ticket. A ticket fired in the last 5 minutes still finds the printer on its own once the switch is on; choose Print for older tickets still needed.

The printer setup form after pressing Test connection: 'Connected to 127.0.0.1:58703 · Connected · EPSON TM-T82X' printed beneath the Save printer, Print test page, Test connection and Cancel buttons.

What Test connection reports once macOS's Local Network switch is back on for EasyKOT: the confirmation step 3 asks for.

Start free — 3 months, no cardDemo on WhatsApp
In the Desktop App

What the printer's row says.

Every printer you have added has a row in Settings → Printers & KDS, and the row carries its own status in words rather than a green dot. These are the exact words for this one.

  • While it is wrong: “macOS is blocking local network”, with the line “System Settings → Privacy & Security → Local Network → allow EasyKOT.” When every network printer has failed this way, the Desktop App also raises a one-time sticky notice titled “macOS may be blocking local network” carrying the same two-click fix: sticky, because the fix is outside the app.
  • Once it is fixed: “Connected”. Tickets still inside their 5-minute retry window go out on their own; anything that had already stopped waits for Print on its row.

The Desktop App says “may be” in the notice on purpose. macOS returns the same unreachable error for a refused prompt and for an address that genuinely has no route, so this is a strong hint rather than a certainty: worth checking first on a Mac, and worth ruling out before you go looking at the router.

Nothing is lost

Printing what was missed.

  • Nothing printed, and nothing was lost. Every ticket fired while the switch was off is in the print queue in Settings → Printers & KDS, retrying on its own schedule.
  • A fresh ticket finds the printer on its own; an old one needs a tap. Fired in the last 5 minutes when the switch goes on, a ticket still prints itself. Older tickets stopped retrying and sit in Settings → Printers & KDS waiting for Print on the row.
  • Reprint by hand if you want the paper now. Reprint last receipt and Reprint last KOT are on the same screen, and failed tickets offer Retry now; older tickets offer Print.
Straight answers

macOS local network — the questions that follow.

I never saw the question — how do I turn it on now?
The prompt appears once and cannot be summoned again, so go straight to System Settings → Privacy & Security → Local Network. EasyKOT will be in the list of apps; switch it on. If it is not listed at all, quit and reopen the Desktop App: an app has to attempt something on the LAN before macOS lists it.
Why does macOS ask this at all?
Because talking to devices on your own Wi-Fi reveals what is on it, and Apple treats that as private information. It is the same prompt AirPlay apps and smart-home apps get. EasyKOT needs it for the two things it does on your network: finding and printing to your printers, and linking Desktop Apps in the same store.
Is this the same on an iPhone or iPad?
There is no iOS prompt to compare it to yet: the iPhone captain app is not in the App Store. When it ships, iOS will ask the same Local Network question, and refusing it will make every Wi-Fi printer unreachable from the phone in the same way; the switch lives in the iOS Settings app under Privacy & Security → Local Network. Android does not prompt for this the way iOS does.
3 months free · ₹0 today · no card

Run it 3 months, then pay for it.

Three months free, full product, no card. Made in India, for the counter: built inside a running restaurant.