Installer handoff

Install and set up Saleculator without prior explanation.

Use this page as the single handoff for a technician, hardware vendor, or AI assistant helping a customer install Saleculator on Windows, Linux, Raspberry Pi, standalone POS, or a network POS setup.

Download release Start trial

What Saleculator is

Saleculator is an offline-first POS application for retail, restaurant, and delivery operations. It runs locally, uses MySQL, and can be installed as a single-machine POS or as multiple POS devices sharing one central MySQL database.

Supported database

Use MySQL only. Do not attempt PostgreSQL, SQL Server, SQLite, or cloud-only database substitutions for the current public release.

Supported packages

Normal Windows customer self-installation is paused until the public installer is signed. Hardware vendors and Linux/Raspberry Pi technicians can use the runtime ZIP containing the bundled libraries, scripts, and Saleculator.jar.

Activation

New evaluators can use the 30-day trial flow from the Saleculator activation screen. The preserved trial URL used by older clients is https://api.saleculator.com/trial.

Universal install sequence

Follow this order on every machine

Confirm whether this is a standalone POS, main POS with local database, or client POS pointing to a central database.
Install Java 17 if the selected package or setup flow does not already provide a suitable runtime.
Install or identify the MySQL server. For one machine, MySQL may run locally. For many machines, use one central MySQL host.
Check the release metadata first. Use the runtime ZIP only for technical/vendor deployments until the Windows installer is signed for customer self-installation.
Run First Run Setup and enter the MySQL host, port, database name, username, and password.
Open Saleculator, complete activation or trial request, and confirm the PIN login screen appears.
Test billing, receipt printer, scanner, cash drawer, scale, reports, backup, and restart behavior.

Windows quick path

Check the download page before starting. If the Windows installer still shows signing pending, do not guide a normal customer to run it; wait for the signed installer or use a technician-led runtime ZIP deployment.

Linux quick path

Install Java 17 and MySQL access, unpack saleculator-4.5.1-runtime.zip, keep lib and Saleculator.jar together, run preflight, then start from the bundled Linux script.

Raspberry Pi appliance quick path

Use minimal Debian, install Java 17, unpack the runtime ZIP, validate peripherals after reboot, and configure boot to show the Saleculator bootstrap loader followed by the PIN login screen.

Network POS quick path

Set up one central MySQL database and configure every POS machine with the same database URL. Use static IP or reliable LAN DNS for the MySQL host.

Common fixes

Things to check before escalating

If Saleculator does not start, verify Java 17 and that Saleculator.jar is in the expected folder with the bundled lib directory.
If database login fails, verify MySQL host, port, firewall, username, password, and database permissions.
If a network client fails, test MySQL access from that exact POS machine, not only from the server.
If printer or scanner fails, test the device in the operating system first and then retest inside Saleculator.
If trial activation fails, confirm internet access to api.saleculator.com and collect support-info output.

Visual assets to add

Screenshots, videos, and graphics planned for this page.

Video placeholder

Full AI-assisted setup walkthrough

Record a 3-5 minute walkthrough from download status through First Run Setup, trial request, PIN login, test sale, and backup.

ph-handoff-ai-install-video

Graphic placeholder

Business-type setup examples

Use one graphic showing retail, supermarket, restaurant, and delivery setup choices with the same Saleculator installer flow.

ph-handoff-business-types

Screenshot placeholder

Support-info output example

Show a sanitized support-info report with Java, MySQL, package, and device checks but no passwords or serial keys.

ph-handoff-support-info

Copy-paste AI prompt

Use this with any AI assistant during installation.

Replace the bracketed parts with the customer's shop details, then paste it into the AI tool helping with setup.

You are helping me install and set up Saleculator POS for my business.

My business type is: [normal retail shop / supermarket / grocery / restaurant / cafeteria / delivery counter / service business / other].
My setup is: [single machine / main POS with local MySQL / multiple POS devices using one central MySQL server].
My operating system is: [Windows / Linux / Raspberry Pi or minimal Debian].
My database plan is: [MySQL on this machine / central MySQL server on the network].
My printer and devices are: [receipt printer / barcode scanner / cash drawer / scale / customer display / none yet].
My trial or license status is: [I want a 30-day trial / I already have a serial key].

Please guide me step by step. First check the latest Saleculator release metadata from https://saleculator.com/releases/latest.json and follow the installPolicy for each file. Do not ask me to run an unsigned Windows installer if the metadata says customer install is blocked. Help me install Java 17 if needed, set up or connect to MySQL, run First Run Setup, request or enter my trial/license key, reach the PIN login screen, configure business details, test one sale, test receipt printing, and confirm backup from the maintenance screen. Keep all database passwords and license keys out of this chat unless I explicitly choose to share them.

Windows guide Linux guide Raspberry Pi guide Network POS guide