1 Introduction

This documents how to install PearlPOS on Windows/MacOS

2 Installation of QZ Tray

QZ Tray is an  cross-browser, cross-platform plugin for sending documents and raw commands to a printer or attached device. Build with HTML, JavaScript and Java. POSBE uses a premium version of QZ Tray to communicate with the localhost to get PC information, print receipts, handle the cash drawer, manage the customer display and more.

QZ Tray FAQ

Installation Guide

1. Download QZ Tray v2.1.2 (from attachment in this document or visit https://qz.io/download/).
2. Install the recommended version of Java (prerequsite for QZ Tray). The recommended version is OpenJDK 11 (LTS). Read more about it here.
   1. If you are not doing a "silent installation" of QZ Tray you will be promtet to install Java during the installation of QZ Tray. If you are, you need to install Java first.
3. Installation (skip this step if you are doing the installation method in chapter 4.2)
   1. Normal installation: Doble click the QZ Tray .exe-file and follow the instructions.
   2. Silent installation: read a guide here

3 Run POSBE as Progressive Web APP (PWA)

Prerequsites

• QZ Tray (and java) installed (see chapter 2)
• Chrome

PWA is the recommended way to run POSBE. It offers full offline capabilities and pincode login.

3.1 PWA Setup

POSBE is delivered with a standard launchpad for PWA. If you want your own icons, title etc you need to change the default settings for PWA.

1. Go to Planet 9 Cockpit -> Run -> Launchpad.
2. Select Launchpad "POSBE".
3. Go to tab "General". Here you can change the following attributes (leave the others untouched):
   • Title: The name of your PWA. This is the name that will appear on the App icon on the clients desktop. Atleast it is recommended to add the system role to the title for development and test. Example: POSbE Test
   • Custom logo: Change this according to your needs. Please use your own folder under "Root" for your assets.
   • Default provider: Change to your default login provider.
   • Custom Login Title: Add a title to the Login screen
   • **Custom Login SubTitle:**Add a subtitle to the Login screen
4. Go to tab "PWA". Here you can change all attributes according to your need.