Display Connection Troubleshooting
What it does
This page helps you fix a kitchen display, customer display or order status display that does not connect to the POS, or that has stopped updating. Find your symptom in the tables, read the likely cause, then follow the fix.
Start with these five checks
Most connection problems are found by these checks.
- Check that the POS app is open on the POS terminal. Displays connect to the POS app itself.
- On the POS, tap Settings, then tap Connected Displays. Read the status at the top right. It must read Listening on port 59590 (or your own port number).
- On the POS, tap Settings, then tap Device. Note an address under Network addresses and the number in Local socket port.
- On the display, open the connection settings. Check that the address and the port match the POS exactly.
- Check that the display and the POS are on the same Wi-Fi or wired network. A guest Wi-Fi network does not work.
INFO
🔒 Manager only - the Settings menu on the POS is only shown to staff who have permission to see it.
Find your symptom
The display has never connected
| Symptom | Likely cause | Fix |
|---|---|---|
| The display keeps trying to connect. The POS reads Listening on port ... | The address or the port on the display is wrong | Enter the address and port from Settings → Device on the display again |
| The display keeps trying to connect. The address and port are correct | The display and the POS are on different networks | Connect both devices to the same Wi-Fi or wired network |
| The POS reads Display server not running | The POS is open in a web browser. The browser version has no display server | Use the POS app installed on Windows or on a tablet. Displays cannot connect to the browser version |
| The POS reads Server error on port ... and shows a red banner | The display server could not start on that port | Follow Fix a display server that could not start |
| Someone changed Local socket port, and no display connects on the new port | The POS has not been restarted since the change | Close the POS app and open it again. Then enter the new port on every display |
| The Device tab shows no Network addresses | The POS device is not connected to a network | Connect the POS device to the Wi-Fi or wired network, then open Settings → Device again |
| Everything above is correct, and the POS or the display runs on Windows | Network discovery is turned off in Windows | Follow Windows steps: turn on network discovery |
The display connects, then disconnects straight away
| Symptom | Likely cause | Fix |
|---|---|---|
| The kitchen display shows a message that the plan does not include Kitchen Display Screen (KDS) | The venue's subscription plan does not include the kitchen display | 🔒 Manager only - contact Pratham to add the kitchen display to the plan. Then tap Refresh in the POS side menu, and tap the refresh icon on the connection on the display |
| The order status display shows a message that the plan does not include Order Status Display (ODS) | The venue's subscription plan does not include the order status display | 🔒 Manager only - contact Pratham to add the order status display to the plan. Then tap Refresh in the POS side menu, and tap the refresh icon on the connection on the display |
| The connection on the kitchen display or order status display shows a grey dot or badge after one of the messages above | The display stopped connecting after the POS refused it | Tap the refresh icon on the connection after the plan is changed |
The POS does not check the subscription plan for customer displays.
The display was working and has stopped
| Symptom | Likely cause | Fix |
|---|---|---|
The connection on the kitchen display or order status display reads ERROR | The display tried 10 times, 5 seconds apart, and then stopped trying | Tap the refresh icon on the connection |
The connection on the kitchen display or order status display reads CLOSED | The connection dropped and the display is trying again | Wait, or tap the refresh icon on the connection |
| The customer display shows Connection Error, or it has gone back to the setup screen | The customer display could not reach the POS three times in a row | Check the POS is open. Enter the address and port again, then tap Connect |
| No display connects after the router or the POS device was restarted | The address of the POS changed | Read the new address in Settings → Device. Enter it on every display |
| The display is listed as Idle in Connected Displays | The POS has had no signal from the display for 60 seconds | Check that the display device is turned on and still on the network. Then restart the display app |
| The display is missing from Connected Displays | The display is not connected | Check the connection on the display itself, using the rows above |
The display is connected but does not show what you expect
| Symptom | Likely cause | Fix |
|---|---|---|
| An order is missing from the kitchen display | The POS sent the order while the display was disconnected | Send the order to the kitchen again from the POS |
| The kitchen display shows no orders on the tab you are viewing | An order type filter is on, or the orders are on another tab | Tap All in the filter. Check the Incoming tab for pre-orders. See Kitchen Display |
| The customer display never shows the cart | Media only is turned on | 🔒 Manager only - turn off Settings → Customer Display → Screens → Media only, then tap Send to display |
| The customer display ignores a setting you changed | The change has not been sent to the display | 🔒 Manager only - tap Send to display on the Customer Display tab, or tap Refresh in the POS side menu |
| The customer display shows the logo in place of your media | The media group has no media in the shape the display needs | See Customer Display |
| An order leaves the order status display as soon as it is paid | Order status mode is turned off on the POS | See Order Status Display |
Read the Connected Displays screen
🔒 Manager only - on the POS, tap Settings, then tap Connected Displays.
The status at the top right
| Status | Colour | What it means |
|---|---|---|
| Listening on port 59590 | Green | The POS is ready. Displays can connect on that port |
| Server error on port 59590 | Red | The display server could not start. No display can connect |
| Display server not running | Grey | The display server has not started. This is what the browser version shows |
The list of displays
| What you see | What it means |
|---|---|
| Active (green dot) | The POS had a signal from the display within the last 60 seconds |
| Idle (amber dot) | The POS has had no signal from the display for 60 seconds or more |
| No devices connected | No display is connected. The screen shows Connect on port ... with the port to use |
- The list updates on its own as displays connect and disconnect. There is no refresh button.
- Tap a tile at the top - Total Devices, Kitchen Displays, Customer Displays or Order Status - to show one type of display only.
- Tap a row to open Device Details. It shows IP address, Last activity, Connected at and Device ID.
See Connected Displays.
Fix a display server that could not start
The Connected Displays tab shows a red banner reading Display server could not start on port ... with a short explanation.
| The banner says the port is... | What it means |
|---|---|
| Reserved by the system or needs extra permission | The device does not allow the POS to use that port |
| Already used by another application | Another program on the POS device is using the same port |
🔒 Manager only - change the port:
- If another application is using the port, close that application.
- On the POS, tap Settings, then tap Device.
- Enter a different number in Local socket port, for example
59591. - Tap Save changes.
- Close the POS app and open it again. The new port is not used until the POS restarts.
- Tap Settings, then tap Connected Displays. Check that the status reads Listening on port 59591.
- Enter the new port on every display.
See Device settings.
What each display does when the connection is lost
| Display | What it does on its own | What you do if it does not come back |
|---|---|---|
| Kitchen display | Tries again 10 times, 5 seconds apart. Then it stops and the connection reads ERROR | Tap the settings icon, tap Connections, then tap the refresh icon |
| Order status display | Tries again 10 times, 5 seconds apart. Then it stops and the connection reads ERROR | Tap the settings icon, then tap the refresh icon |
| Customer display | Keeps trying. After three failed tries it shows Connection Error, then goes to the setup screen after 10 seconds | Check the address and port on the setup screen, then tap Connect |
Windows steps: turn on network discovery
These steps apply to any Windows device in the connection - the POS computer, or a display device that runs Windows. Do them on both when both run Windows.
When network discovery is off, devices on the same network cannot find each other. The display cannot reach the POS, and the POS cannot see the display. You change this once per device.
WARNING
You do these steps in Windows Settings, not inside the POS app. You need administrator access on the Windows device.
Windows step 1 - Open Network & internet settings
- Click the Start button.
- Click Settings (the gear icon).
- Click Network & internet in the left sidebar.
- Scroll to the bottom.
- Click Advanced network settings.

Windows step 2 - Open Advanced sharing settings
- Find the More settings section.
- Click Advanced sharing settings.

Windows step 3 - Turn on Network discovery and File and printer sharing
Do this for both Private networks and Public networks. Windows marks the network you are on as Current profile, but it can switch between the two. Turning on both stops the problem from coming back.
- Expand Private networks.
- Toggle Network discovery to On.
- Tick Set up network connected devices automatically.
- Toggle File and printer sharing to On.
- Expand Public networks.
- Toggle Network discovery to On.
- Toggle File and printer sharing to On.

Windows step 4 - Connect the display again
- Open the display app.
- Enter the address and port of the POS.
- On the POS, tap Settings, then tap Connected Displays.
- Check that the display is in the list.
TIP
If the display still does not connect, close the POS app and open it again. Then close the display app and open it again.
Messages you may see
| Message | Where | What it means and what to do |
|---|---|---|
| Your current subscription plan does not include access to Kitchen Display Screen (KDS). Please upgrade your plan to use this feature. | Kitchen display | The plan does not include the kitchen display. The display disconnects. 🔒 Manager only - contact Pratham |
| Your current subscription plan does not include access to Order Status Display (ODS). Please upgrade your plan to use this feature. | Order status display | The plan does not include the order status display. The display disconnects. 🔒 Manager only - contact Pratham |
| Connection Error - Unable to connect to the POS system. | Customer display | The display could not reach the POS. Check the POS is running, the address and port are correct, and both are on one network |
| Invalid IPv4 address | Customer display | Enter the address as four numbers separated by dots, for example 192.168.1.10 |
| Invalid port number | Customer display | Enter a whole number from 1 to 65535 |
| IP address is required or Port is required | Kitchen display, order status display | Fill in both fields before you add the connection |
| Display server could not start on port ... | POS, Connected Displays | See Fix a display server that could not start |
| Server error on port ... | POS, Connected Displays | The same problem, shown in the status at the top right |
| Display server not running | POS, Connected Displays | The display server has not started. Use the installed POS app, not the browser version |
| Restart the POS after changing this | POS, Device | A reminder under Local socket port. A new port is only used after the POS restarts |
| No devices connected | POS, Connected Displays | No display is connected to this terminal |
Still not connecting?
Have these ready before you contact support:
- The address under Network addresses and the Local socket port from Settings → Device
- The status at the top right of Settings → Connected Displays
- The address and port entered on the display
- Any message the display shows
- What the display device runs on, for example Windows or Android
See Contact support for Pratham support contact details.
FAQs
Where do I find the address and port of the POS?
On the POS, tap Settings, then tap Device. The addresses are under Network addresses on the right. The port is in Local socket port. It is 59590 unless someone changed it.
Can a display connect to the POS when the POS is open in a web browser?
No. Only the POS app installed on Windows or on a tablet runs the display server. In the browser version, Connected Displays reads Display server not running.
I changed the port on the POS. Why can no display connect?
Two things are needed after a port change:
- Close the POS app and open it again. The new port is not used until the POS restarts.
- Enter the new port on every display. Displays keep using the old port until you change it. :::
Is there a refresh button on the Connected Displays screen?
No. The list updates on its own when a display connects or disconnects.
Why does the kitchen display stay on ERROR when the POS is back on?
The kitchen display stops trying after 10 tries. Tap the settings icon, tap Connections, then tap the refresh icon on the connection. The order status display works the same way.
Why did the address of the POS change?
Most routers hand out addresses on their own, and the address can change after the router or the POS device restarts. Ask the person who looks after your network to give the POS device a fixed address.
Can one display connect to more than one POS terminal?
The kitchen display and the order status display can. Add one connection for each POS terminal. The customer display connects to one POS terminal.
Does the display need the internet, or only the local network?
The display talks to the POS over the local network. The kitchen display also loads its order types and statuses over the internet, and the customer display downloads its media over the internet.
