Web KDS Installation

System requirements

Kitchen service machine

Software
- Operating system: Windows 10 1607 or later
- Software: .NET Version 8 Hosting Bundle or above
- SQL Server 2019, SQL Server 2019 Express, or later
Hardware: Minimum requirements
- Processor: 2 GHz or faster
- 2 GB RAM
- Hard disk: 5 GB free space

The installer for the Web KDS installs the .NET version needed and can also install the SQL Server Express.

Install the Web KDS service

To install the Web KDS:

Run the installer for LS Central version 25 or later.
At the bottom of the list, you find the Web Kitchen Service for LS Central.
Click Install.

The Kitchen Service requires an SQL database to store orders and configurations. If you do not have an SQL Server ready to use, the installer can install Microsoft SQL Server Express for you.

Select the Microsoft SQL Server Express field, if you want to install the database server; if not, leave the field blank. Click Next.
In the Arguments page, fill in the mandatory Site Password field. Create a password required for accessing the Web KDS Configuration page.
Other fields configure the connection to your SQL Server, the name of the SQL Database that is created upon installation, and the Windows user that will run the Web Kitchen Service.
When you have filled in all required information, click Next.

You are now ready to run the installation.

The Option button lets you change the Update Strategy from Manual to Automatic.

The Show details link shows you additional information about the configurations entered in the previous steps.

Click the Install button. When the installation has been completed, click Close to close the installer.
Open Windows Services, and make sure the LS Retail Web Kitchen Service is running.

LS Central configurations

Before you can connect the Web KDS to LS Central, you must make sure the web services are set up correctly:

Open your LS Central instance, version 25 or later, and open Web Services. If a line for codeunit 10000992 does not exist, you must create a new line with the following information:

Object type	Object ID	Object Name	Service Name
Codeunit	10000992	LSC KDS Rest Service	KDSRestService

This service should be published.

Next, open the Kitchen Service Configuration.
In the Kitchen Service Configuration page, click the Refresh WS-Info action.
Change the Kitchen Service (KDS) in use to Web KDS.

Web KDS configurations

Open services, and start the LS Retail Web Kitchen Service.
Open a browser, and open http://localhost:8052 to open the Web KDS home screen.
Click the Configurations button in the top-right corner.
Enter the password you created in the installation process to get to the Configurations page.
Click the LS Central Connections button.
Click the Add Connection button to create a new connection.
On the Connection Info page, enter the connection details for your LS Central instance.

Select, whether you are connecting to an On-premises or SaaS instance of Business Central.

If On-premises

Field	Description
ID	Enter the name of the connection.
Web Service Name	Enter the name of the KDS web service, the default is KDSRestService.
Config source	Select this field, if this connection should be the source of configurations for the Web KDS. As the Web KDS can get orders from multiple Business Central instances, you must define which one has the configurations of the stations and routing.
Instance	Enter the name of the LS Central instance you are connecting to.
Company	Enter the name of the Business Central company to connect to.
URL Base BC Connection	Enter the URL of the Business Central instance you want to connect to. It should include the connection protocol, for example http://localhost.
Port	Enter the port of the web services. The default port is 9048. Make sure this port is open for connection.
Domain	Enter the domain for the user
Stores to Filter	Enter which store or stores this Web KDS should show orders for. If the Web KDS service should service all stores the filter can be left empty.
User	Enter the user name for a Business Central user that is allowed to connect to LS Central.
Password	Enter the password for this user.
Encrypt	Select this field for the password to be encrypted in the application settings files.

If SaaS

Field	Description
ID	Enter the name of the connection.
Web Service Name	Enter the name of the KDS web service, the default is KDSRestService.
Config source	Select this field, if this connection should be the source of configurations for the Web KDS. As the Web KDS can get orders from multiple Business Central instances, you must define which one has the configurations of the stations and routing.
Instance	Enter the name of the LS Central instance you are connecting to.
Company	Enter the name of the Business Central company to connect to.
URL Base BC Connection	Enter the URL of the Business Central instance you want to connect to. It should include the connection protocol, for example https://api.businesscentral.dynamics.com
URL For Authentication	Enter the URL of the login service, for example https://login.microsoftonline.com
Stores To Filter	Enter which store or stores this Web KDS should show orders for. If the Web KDS service should service all stores, you can leave the filter empty.
Scope	The default scope is .default
Version	Enter the version of the Web Services. (v2.0)
Tenant ID	Enter the ID of the SaaS tenant which is required to obtain the oAuth Token.
Client ID	Enter the ID of the SaaS client.
Client Secret	Enter the client secret.

Click the Test Connection button to verify that the connection you configured is working.
When the connection has been tested and is working, be sure to click Save Connection.
Create your kitchen stations, kitchen screens, and routing in LS Central.
When that is done, go back to the Settings page at your Web KDS http://localhost:8052/admin, and click Reload configurations.