Basic - How to pair KDS server with client when two servers are on the same network

Basic - How to pair KDS server with client when two servers are on the same network

1.0 How KDS Server and KDS Clients work.

1.1 KDS Server

  1. The completed order from the POS system is directly sent to the KDS Server and the connected KDS clients. Typically, the sales data will display the order details. 
  2. The KDS server stores and organizes the incoming orders, then distributes them to the appropriate KDS clients. 
  3. The server also communicates with the KDS clients to update the order status, such as marking items on Stage Configuration as “Order”, “Pickup” or “Collect.” 
  4. In environments with multiple KDS clients (for different kitchen sections, such as Food and Beverages), the server ensures that all clients are synchronized with the latest order information.
  5. It is possible to have multiple KDS servers on the same network to control and route orders to different channels. For example, one KDS server can handle orders for Dine-in/Takeaway, while another KDS server manages orders for the Drive-Thru.

1.2 KDS Clients

  1. The KDS client is typically a display device, like a screen or tablet, located in the kitchen or bar area. 
  2. Once the server sends the order, it is displayed on the KDS client’s screen, showing the items ordered, preparation instructions, timing, and table number. 
  3. KDS clients are updated in real time, meaning any status changes (e.g., when a dish is marked as completed) are instantly reflected on all connected clients.


2.0 How to pair KDS server with client when two servers are on the same network?

It is possible to have multiple KDS servers on the same network to control and route orders to different channels. For example, two KDS servers can be set up for Dine-in/Takeaway and Drive-Thru, with a single KDS client. 

The KDS client can be configured to retrieve data from the appropriate KDS server based on the order channel, allowing for seamless management of orders across multiple service types.

2.1 Open Both KDS Server and Client.

  1. Launch both KDS servers and KDS client.

A screenshot of a computerAI-generated content may be incorrect.


A screenshot of a login boxAI-generated content may be incorrect.




2.2 Configured the terminal name to be the same for both the KDS server and clients

  1. The pairing between the Server and Client KDS is based on the terminal name. Additionally, both the client and server KDS must be on the same network. If you set the server KDS terminal name as 'KDS', the client KDS terminal name must also be set to 'KDS' for the client and server to pair successfully
  2. Each KDS server must have a unique terminal name to avoid conflicts during pairing.
  3. Once the correct pairing is set, the client KDS will automatically fetch the server KDS's IPv4 address. 
  4. To confirm the pairing, check the settings under 'General' on the client KDS to ensure the displayed IP address matches the server KDS's IPv4 address.

A screenshot of a computerAI-generated content may be incorrect.


3.0 Sample Case

Even though the Server and Client KDS are paired with the same terminal name, Client KDS is not updating to reflect the Server KDS's IPv4 address.

3.1 Follow steps below

  1. Restart both the KDS server and client PC. 
  2. Boot up the KDS server first, then only the KDS client
  3. Check if the IP address on the client has been updated to reflect the server's IP address
    • Related Articles

    • Basic - How To Configure Walk-In Client Name

      How to Configure Walk-In Client Name Change the Walk In Client Name in system configuration (system configuration > Sales > Walk In Client Name [All Outlets])
    • Basic - Getting Started & Installation

      Getting started You should have been given an account to start with. If you have not received an activated account, Kindly contact info@xilnex.com for registration. Installation 1. The installation file can be obtained from Xilnex Portal 2. Login to ...
    • Basic - E-Invoice Dashboard

      E-Invoice Dashboard You can view the E-Invoice Dashboard by login to the Xilnex portal using this link – E-Invoice Dashboard Or E-invoice Dashboard can be found under the [Integration] tab in Xilnex portal Then click on Malaysia LHDN E-invoicing > ...
    • Basic - How to check bounce email

      1.0 What is bounce email? A bounced email, or bounce, is an email message that gets rejected by a mail server. When an email bounces, it has for some reason did not reach the intended destination. A bounced email can be either a hard bounce or a soft ...
    • Basic - Getting started with AnyDesk

      What is AnyDesk? AnyDesk is a remote desktop application distributed by AnyDesk Software GmbH. The proprietary software program provides platform-independent remote access to personal computers and other devices running the host application. AnyDesk ...
    • Recent Articles

    • Available Events: Xilnex Event Hub

      Last Updated: 05 May 2026 Sales # Event Name 1 Create Sales 2 Confirm Sales 3 Confirm Sales v2 4 Complete Sales 5 Complete Sales v2 6 Cancel Sales 7 Update Sales 8 Cancel Sales Order 9 Confirm Sales Order 10 Complete Sales Order 11 Post Quotation to ...
    • Integrating with Xilnex: Event Triggers & Webhook Configuration

      Overview Xilnex Event Hub is an integration framework that enables your system to automatically dispatch real-time notifications to external applications whenever a defined business action occurs — such as completing a sale, creating a client, or ...
    • LiveOrder New UI Announcement

      LiveOrder — New Ordering Experience Now Available What's New? We're excited to introduce LiveOrder New UI, a redesigned ordering experience built to make ordering faster and easier for your customers. What's Changing — and Why It Matters We've ...
    • How to Cancel an E-Invoice on Dashboard

      Overview Sometimes cancelling an e-invoice is inevitable. Common situations include: Incorrect buyer information (e.g., wrong name, TIN, or address) Transaction was voided or order was cancelled after invoice issuance Duplicate e-invoice issued for ...
    • Guidelines to Set Up Promotion for Walk-in (System Default)

      Guidelines to Set Up Promotion for Walk-in (System Default) Previously, the system did not have a specific indicator for walk-in customers. As a result, all promotion rules applied equally to all customer types, including walk-in customers. However, ...
    • Popular Articles

    • Basic - How to create a voucher-coupon

      Voucher and coupon definition Voucher can be generated in bulk and can be used once Coupon can only be created one at a time (reusable code) and can be use multiple times Pre-voucher / coupon setup There are 2 things need to be prepared before we can ...
    • Understanding DuitNow QR Payment in ClassicPOS

      Introduction This document introduces the DuitNow QR payment feature available in the Xilnex Retail POS, enabling merchants to accept payments conveniently through Malaysia's national QR payment standard. The integration of DuitNowQR simplifies the ...
    • Basic - How to change custom cost to another branch that don’t have custom cost

      Change custom cost to another branch that don’t have custom cost 1. Get the item list from the location with custom cost (Item Code, Name, Custom Cost) 2. Make sure the Show Location Price are selected 3. Export the item list in Excel 4. The file ...
    • Intermediate - How to Bill & Post to Sales from Transfer Note

      1.0 Purpose A bill is required from transfer note when an inventory transfer involves financial transactions, cost allocation, or compliance with tax and accounting regulations. It is used when stock is moved between outlets that operate as separate ...
    • Basic - How to enable E-Receipt Portal and QR Code Setup on Printing format in Xilnex

      Enable E-Receipt Portal Enable the E-receipt functionality Once Enabled, you will be getting the E-Receipt portal link Continue under Theme & Styling, enabled for the E-Invoice (LHDN) You can customize the look and feel of the E-Receipt portal ...