Install guide

Install Saleculator on Raspberry Pi

Saleculator can run like a dedicated POS device on Raspberry Pi class hardware: boot, show the Saleculator bootstrap loader, and continue directly to the PIN login screen.

Download latest release Start 30-day trial

Install minimal Debian

Start from a minimal Debian-compatible image suitable for the hardware vendor's display, printer, scanner, and network requirements.

Install Java and MySQL access

Install Java 17. MySQL may be local for a single device or central on another machine for multi-device shops.

Deploy runtime package

Unpack the runtime ZIP, run preflight, and verify that Saleculator.jar starts from the bundled Linux script.

Lock down startup

Configure the device to show the Saleculator bootstrap loader at boot and continue directly to the Saleculator PIN login screen.

Checklist

Before handing over the POS

Validate thermal performance, power stability, storage quality, and automatic restart behavior before customer handover.
Confirm all USB/serial peripherals after reboot, not only during first setup.
Document the MySQL database URL used by the device for future service.

Visual assets to add

Screenshots, videos, and graphics planned for this page.

Screenshot placeholder

Install Saleculator on Raspberry Pi First Run Setup

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

ph-install-raspberry-pi-first-run

Screenshot or video placeholder

Install Saleculator on Raspberry Pi handover proof

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

ph-install-raspberry-pi-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.