Installer App Installation

Installer App - what is it?

Installer is an application that is running locally on your register machine and communicates with the POS Brazil. It is needed to be used in order to integrate Brazil POS with different hardware devices such as payment terminals, printers, cash drawers, etc. To ensure the continued security of communication between our cloud POS application and your Register computer, the Installer uses a certificate.

Installation process

In order to download and install the Installer App please follow the steps below:

Navigate to Erply Wizard environment https://posow.erply.com/
Login with Erply credentials (Erply ID, username, password)
Go to Hardware -> Installer App -> Installation
The systems shows you that Installer not connected:

In order to install the Installer App choose an operating system
Note: Erply wizard automatically detects your operating system and recommends the correct file for downloading.

Click on the download link that is accessible by clicking on the “here”:

After downloading the Installer App click on the Test Connection button:

The Installer version will be shown in the Wizard:

If you still see that the Installer not connected, please refresh the page:

Then click on the “Test connection” once again.

Install for Widows

Navigate to the Erply Wizard https://posow.erply.com/hardware/installer/installation/*
Login with Erply credentials (Erply ID, username, password).
Navigate to Hardware -> Installer App -> Installation.
Download the file installer2_windows_amd64.msi:

Once the file is downloaded click on it twice and start the installation process.
Once you will see the following window please click on the “More info” button -> “Run anyway”.

Proceed with installation.

Once installation is finished navigate to the https://posow.erply.com/hardware/installer/installation/* Hardware -> Installer App -> Installation.
Press Test connection to see the Installer App status - there should be a message “Installer is running - v. x.x.x” on a green background:

Navigate back to the POS page and refresh the page. In case it does not help, try to clear the cache and refresh page once more:

Install for MacOS

Once the file is downloaded click on it and start the installation process.
If the computer does not allow you to install it, please navigate to the System Settings -> Privacy and Security, click on the Open Anyway:

Continue with installation

Navigate back to the POS page and refresh the page. In case it does not help, try to clear the cache and refresh page once more:

Install for Linux

Open a terminal window on your computer and paste the following command line:
systemctl start installer2.service

Click Enter. If the terminal requires your password, please enter it.
Now the Installer is running again.

Navigate back to the POS page and refresh the page. In case it does not help, try to clear the cache and refresh page once more:

Mobile ERPLY POS applications

Mobile ERPLY POS application do not require Installer App!!

ERPLY Brazil POS mobile applications are working based on the SDK - Software Developer Kit.
SDK does not require certificate update.

Updating Installer App

If there is a new Installer version released it needs to be updated. In order to do that follow steps below:

Open Onboarding Wizard, by going to: https://posow.erply.com/
Navigate to Hardware -> Installer App -> Installation
Choose correct operating system

Click on the Update Installer:

The updated Installer version is displayed as on the picture below:

Go to the POS page https://epos.erply.com/
Login with Erply credentials (client code, username, password)
Click on the following icon:

Check the information in the popup. The Isntaller version should correspond to the version that is in the Wizard:

Troubleshooting steps

In case you experience any issues with microservices or Installer please follow steps below:

In the Wizard https://posow.erply.com/
Login with Erply credentials (client code, username, password).
Navigate to the Hardware -> Installer App -> Installation
Press Test connection to see the Installer App status.

If no connection is detected

try updating the Installer App on the settings page (press Update Installer button):

Frequently Asked Questions

How to uninstall the Installer App?
If you need to reinstall or uninstall the Installer App, please first uninstall the microservices from Erply Wizard (https://posow-sb.erply.com/).
To uninstall the installer app:

On Windows:
Open the Windows Services Manager and stop the micro-service.
After that, please open the Control Panel -> Add or remove programs and uninstall the app called Installer.
Please do not remove the folder under the Program Files -> Erply since it might cause some troubles with reinstallation.

On MacOS:
Open a terminal window and paste the following command line:

cd /Library/Erply/installer2 && sudo ./installer2_darwin -service=uninstall

Press enter. You will be required to enter the computer password.
Once the uninstallation complete, you will need to restart your computer before installing a new installer version.

Which operation systems can be used together with Installer App?
Installer App can be used with Windows, Linux and Macbook devices.

While installing micro services there is a message “Installed successfully” but actually it is not installed. What to do?

This issue is caused by Installer app has been downloaded multiple times and some of them are running at the same time. In order to resolve it you need to leave only one and other ones should be "stopped" and deleted.