# Public Release Page Template

Use this content as the source for `https://www.saleculator.com/releases/4.5.1/`.

## Saleculator 4.5.1

Saleculator is an offline-first POS for Windows, Linux, and Raspberry Pi/minimal Debian appliance deployments. It runs locally, uses MySQL, and does not require cloud hosting or an annual renewal to operate locally.

### Download

- Windows installer: `Saleculator-4.5.1-Setup.exe`
- Vendor/runtime ZIP: `saleculator-4.5.1-runtime.zip`

### Release Metadata

Machine-readable metadata for support tools, installers, and AI-assisted setup:

- Latest release: `https://www.saleculator.com/releases/latest.json`
- Download alias: `https://www.saleculator.com/downloads/latest.json`
- This version: `https://www.saleculator.com/releases/4.5.1/release.json`

### Requirements

- Java 17 or newer.
- MySQL Server for a single-machine POS or the main POS/database machine.
- MySQL client tools for network client machines.
- Same Saleculator installer/build for single-machine and multi-device shops.

### Setup Modes

Single machine or main POS:

1. Install Saleculator.
2. Run **First Run Setup**.
3. Choose **Standalone or main POS database on this machine**.
4. Enter the MySQL admin password and the Saleculator database user password.
5. Start Saleculator and approve database creation if prompted.

Network client:

1. Install Saleculator on the extra POS machine.
2. Run **First Run Setup**.
3. Choose **Network client connecting to an existing POS database**.
4. Enter the database server IP/name, database name, user, and password.
5. Start Saleculator and login with the assigned user/PIN.

The only configuration difference in a multi-device shop is `db.URL`: all POS machines point to the same MySQL database.

### Trial

New customers can request a 30 day trial key from the Saleculator activation screen using **START TRIAL**. Paste the trial serial key into Saleculator and activate it.

### Release Notes

- Final application JAR is `Saleculator.jar`.
- Release JAR is obfuscated with ProGuard.
- Java minimum runtime is now 17.
- Windows installer includes shortcuts for Saleculator, First Run Setup, preflight, support info, and uninstall.
- Runtime ZIP includes Windows, Linux, and Raspberry Pi/minimal Debian deployment scripts.
- Database support is MySQL only.
- First Run Setup guides standalone/main POS and network-client database configuration.
- First-run business setup lets customers configure receipt identity without XML editing.
- Shared MySQL business profile keeps receipt business details consistent across network counters.
- Database setup screen includes local MySQL, network MySQL, and connection-test actions.
- 4.5 database upgrade is safer for existing installations that already contain the `event.close` resource.
- Support info scripts collect installation details without printing configured passwords.

### SHA-256

Replace these values with hashes generated after the final build:

```text
Saleculator-4.5.1-Setup.exe: <sha256>
saleculator-4.5.1-runtime.zip: <sha256>
```

### Help

Run **First Run Setup** after installation. If setup fails, run **Collect Support Info** from the Start Menu and share the generated support file with Saleculator support.
