Install guide

Install Saleculator on Linux

Use the runtime ZIP for Debian and other Linux deployments. The same Saleculator build is used on Windows, Linux, and Raspberry Pi hardware.

Download latest release Start 30-day trial

Prepare the machine

Install Java 17 and MySQL, then create a dedicated Saleculator folder under the operator or vendor-managed account.

Unpack the runtime ZIP

Extract saleculator-4.5.1-runtime.zip and keep the bundled lib, scripts, and Saleculator.jar together.

Run preflight

Use the bundled preflight script to confirm Java, MySQL connectivity, file permissions, and expected POS peripherals.

Start Saleculator

Launch the Linux start script, complete First Run Setup, activate trial or license, then configure autostart if the machine is a dedicated POS.

Checklist

Before handing over the POS

Use MySQL only. Other databases are not part of the supported release path.
For appliance setups, hide the desktop/session choices and boot directly to the Saleculator launcher.
Keep SSH or technician access available for support, but do not expose database passwords in support notes.

Visual assets to add

Screenshots, videos, and graphics planned for this page.

Screenshot placeholder

Install Saleculator on Linux First Run Setup

Show the database mode, MySQL connection, business profile, and activation flow for this setup path.

ph-install-linux-first-run

Screenshot or video placeholder

Install Saleculator on Linux handover proof

Show the successful PIN login screen, test sale, receipt preview or print, and backup confirmation.

ph-install-linux-handover

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.