First-time install manual — for the operator or their employee

Illustrated installation atlas — Android basics, every APK role and cabinet checklist.

Who this is for: the person standing next to a new cabinet at the venue — the operator who owns it, or an employee doing it for them. Goal: from crate to an installed, tested cabinet visible in Operator X. Allow time for site, hardware, payment and access issues; complete required acceptance before opening to shoppers.

Both hardware families are covered: ZHZN (CSM, T3568 board, ZHZN KioskX app) and Reyeah (RK3288, Kiosk X app). Steps that differ are marked.

Approved release prerequisite: use coordinated cabinet, gateway and operator builds containing the audit repairs and reviewed-address flow. The dated demo at the end is historical; version labels alone do not prove the current source is installed. Follow the current visual atlas and the operator interface comparison for supported controls.

The shape of the job. The cabinet introduces itself to the cloud once correctly provisioned and connected. You complete Claim → Locate → Payments → First fill → Go live in Operator X or web field setup, including separate on-site installation confirmation and the physical/payment acceptance checks below.

0. Before you leave the depot

1. Place and power (5 min)

1. Inspect delivery damage and install the cabinet level with the clearance, anchoring, ventilation and power requirements in its actual manufacturer manual. A generic against-the-wall placement is not suitable for every cabinet.
2. Plug in. The vending screen must come up by itself, with no touch. If it does not, the cabinet was not locked to the app at the bench — call support, do not fix it here.
3. Leave it on. Do not power-cycle in the next ten minutes; first boot is when the cabinet registers itself.

2. Network (5 min)

ZHZN

1. Tap the top-left corner 7 times within 5 seconds.
2. Enter the authorized cabinet admin PIN. Use the machine's approved provisioning/hand-over record; do not copy a default from an old guide. A cloud PIN save must reach the actual cabinet before it changes local access.
3. Service menu → Exit kiosk (Android Settings) → Wi-Fi → join the venue network.
4. Press Home. The kiosk returns on its own.

Reyeah

Enter the Kiosk X manager password → Android Settings → Wi-Fi → back to the app.

What happens by itself

After the installer has provisioned the correct machine identity, gateway and device authentication, the cabinet registers and heartbeats. Confirm a fresh matching cloud record. Network connectivity or an operator serial claim alone does not provide a cabinet credential; an enrolment response waiting for arming requires the authorized arming procedure.

ZHZN cabinets that were factory-tested arrive already knowing their vend-board port and tray type: the factory certificate is what /zhzn/register hands back as serialPort and module on first boot. Nobody guesses wiring in the field.

3. Field setup in Operator X (10 min)

Open https://operator.kiosk-x.ai/machines/setup (the Operator X phone app has the same wizard, with a QR scanner for the serial). Five pills across the top show where you are.

The five checks behind Go live — GET /api/v1/machines/{no}/lifecycle shows them:

Do not force incomplete checks green. The normal operator setup path requires readiness, a confirmed address and separate on-site installation evidence for the same serial. Correct failures and verify the returned live status; a saved request or timeout is not proof that the cabinet went live.

Set your real products before First fill and Go live

Inspect the actual catalog. A cabinet may carry a placeholder/demo planogram (Aurora Water, Summit Coffee, Trailblazer Mix, …); those rows and any reported stock are not evidence of your physical products. Open the machine page → Aisles and set each aisle's product, price and capacity to what you loaded. Until you do, the screen shows the placeholders.

4. Prove it sells (5 min)

1. On the cabinet screen, pick a product → Pay now → Scan & Pay → pay the QR with your phone.
2. The product drops. (ZHZN: the storefront vend rides the cabinet's normal pending queue; Reyeah: /apk/createOrder.)
3. In Operator X → machine page → Sales the order appears within a minute, and the aisle count is one lower.
4. If a Nayax reader is fitted, tap once on the reader too. The tap must settle against this serial (Operator X → machine → Nayax).

If the product does not drop, stop and read §6 — do not leave a cabinet that takes money and drops nothing.

5. Leave-site checklist

Gateway readiness, an address match and the saved operator statement do not observe physical delivery, bank settlement or safe installation. Record the actual on-site evidence for these checks.

6. If something is wrong

7. Access and interface boundaries

1. Use a named account with verified setup scope and assigned-machine access. Native Android opens Full console for expanded setup, crew and refund operations; do not substitute shared credentials.
2. Configure actual products and physically verify quantities before first fill. A placeholder catalog or a green stock check is not physical stock evidence.
3. Cabinet credentials are separate from phone registration. ZHZN enrolment waiting to be armed must follow the authorized device-credential procedure; do not assume a fleet-secret fallback makes a cabinet ready.
4. Operator receipt acceptance is the web machine Build & factory QA → Accept this machine action. Flutter's factory signature is the manufacturer's separate record. Perform the physical checks first.
5. Remote test dispensing actuates real hardware. Use the approved supervised service procedure and resolve an existing command/payment before another command. API or UI availability is not permission to test an unattended cabinet.

Appendix — the calls behind the wizard

Historical example, not approval of the current candidate: validated live 2026-09-05 on ZHFTDEMO0905B through the Operator X wizard: claim → locate → Nayax 409 on a reader bound elsewhere, then 200 on the right one → first fill (10 aisles) → checks green → Machine is live.