Emral POS

Windows Installer Runbook

Use this to install and verify the local print agent.

Before You Start

Windows 10 or newer, admin rights required.
Download installer and matching .sha256 from downloads home.
Verify checksum before running installer.

Install

Run Emral-POS-PrintAgent-Setup-vX.Y.Z.exe as Administrator.
Keep default install path unless you have a reason to change it.
Finish setup and allow service registration.

Configure POS

In POS settings, set Agent URL to http://127.0.0.1:17888.
Open C:\ProgramData\EmralPOS\agent-config.json.
Copy apiKey from that file into POS agent API key field.
Save settings and run printer test.

Verify Service

Run this in PowerShell as Administrator:

powershell -ExecutionPolicy Bypass -File "C:\Program Files\Emral POS Print Agent\scripts\status-service.ps1"

Upgrade

Download newer installer version.
Run installer as Administrator.
Installer replaces binaries and restarts service.

Need Help?

Use the Troubleshooting guide.