Applies to: Saleculator POS/PDA 4.5 update 4 (4.5.4), Webin 3.7 and Waiter 1.3.0, as relevant to this guide. Download the published packages from Saleculator Downloads.
Install Webin beside your existing Saleculator database so browsers and the waiter app can connect to the same restaurant data.
Before you start #
- A working Saleculator database and a backup.
- Apache and a compatible PHP runtime. The Webin 3.7 installation baseline is PHP 8.3 with mysqli, mbstring, XML, GD and OpenSSL. Check these components if using a bundled server such as XAMPP.
- The database host, port, database name and credentials supplied by your installer.
- An active Webin user with the required Webin role.
Install the files #
- Download the current Webin ZIP from Downloads.
- Extract its
webinfolder into your Apache document root. For a typical XAMPP installation this isC:\xampp\htdocs\webin. Avoid an accidentalwebin\webinnesting. - Keep other folders and websites in
htdocs. You do not need to delete the document root. - Enable Apache’s rewrite module and allow the supplied
.htaccessrules for this folder. Start Apache and the existing Saleculator MySQL service. Avoid starting a second database service on the same port.
Connect to the database #
The ZIP includes real application/config/config.php and application/config/database.php files. You do not need to rename example files. Packaged database defaults are 127.0.0.1:3306, database saleculator, user root, password password, for the standard local setup. These are database connection defaults, not a promise that your Webin login uses that password.
If your installation differs, edit database.php to match it. XAMPP installations with an empty database password also need that value set correctly. On a case-sensitive server, use the database’s exact name.
An existing Saleculator database is required. Extracting Webin does not create a restaurant database. Do not run the archive’s historical script.sql against an existing database as a routine installation step. Use the current POS database setup/upgrade process for schema changes.
Open Webin and connect a phone #
- On the server PC, open
http://localhost/webin/. - Sign in using the active Webin account configured for this database. If no account is ready, ask the Saleculator administrator to configure it.
- Find the server PC’s local network address. For example, if it is
192.168.1.50, openhttp://192.168.1.50/webin/from a phone on the same network. - Allow the Apache port through the PC firewall for the restaurant’s private network. Avoid guest Wi-Fi that isolates devices.
- Enter the same address in the waiter app and run its connection/setup check. Use the complete address, including a non-default port or folder when applicable.
localhost on a phone refers to that phone, not the POS PC. The phone talks to Webin’s web port; it does not need public access to MySQL.
Private storage and remote hosting #
The PHP service needs permission to write its private waiter recovery directory and session directory. Keep recovery storage outside the served web folder. A technician can set WEBIN_PRIVATE_PATH, SALECULATOR_WAITER_STATE_DIR and WEBIN_SESSION_PATH when needed. Hosted deployments should set a fixed WEBIN_BASE_URL, use HTTPS and keep database access private.
Confirm it works #
Check browser login, page styling, waiter sign-in, menu loading and one test bill request. Missing CSS/images usually indicate an incorrect extraction path, base URL or rewrite setup. A database connection error needs the correct database settings, not a fresh import of historical SQL.
One reply on “Installing Saleculator Webin on Windows”
Is webin working only if on the same network with the pos station?