Skip to main content

Installation and Configuration

Supported platforms and downloads​

The POS client software runs on Windows, Android, Linux and MacOS. Standard installation packages are available for Windows and Android. Please get in contact, if you want to use Snabble von Linux or Mac. All operation modes (POS, SCO and mobilePOS) are supported by the same software and therefore share the same installer packages.

Installer files can be obtained from the Snabble Retailer Portal, or the Portal for Staging.

POS release downloadsPlease find the POS-Release in the menu on the left.
POS release downloads stableAn overview of releases is shown.

You should take the most recent stable version in most cases.
POS release downloads allWith the toggle button, also releases from our latest and beta channel are shown.
POS release download pageSelect a specific release to see the installer package downloads.

For a detailed list of supported hardware see the page Hardware Support

Installation​

Windows Installation​

To install the Snabble POS software on a Windows based computer, simply download the installer file pos-*-windows-x64.msi and execute it on the machine. For full support, Windows 10 Enterprise is required. The software can be executed on other Windows versions, but kiosk mode and auto update mechanisms are only supported on Windows 10 Enterprise.

POS installer startSimple installer package for Windows.
POS installer select componentsPlease select the components to install.

As optional components, there are:
  • Updater service for auto updates (requires Windows 10 Enterprise)
  • Customer display support
  • Support for JavaPOS based hardware, e.g. DieboldNixdorf EASY eXpress
POS installer select kiosk modeThe recommended installation method for the Self Checkout is using the kiosk mode. This requires Windows 10 Enterprise.

Windows auto updater service​

If you selected the Windows updater service during the installation, the POS software will be updated automatically, as soon as a new release is available. Per default updates will be done for all new stable releases. You can change this the release channel to beta or latest releases in the device configuration within the retailer portal.

Select config release channelSelect the release channel in the retailer portal.

Android Installation​

In addition to the retailer portal, the most recent stable version for Android is available over the Google Play Store:

QR code for Snabble POS in Play Storehttps://play.google.com/store/apps/details?id=io.snabble.pos

At least Android 7.0 is required. Simply install the APK from the Retailer Portal or Google Play store. If you plan to use the POS mode with customer display, please also install the customerdisplay-*-android.apk, which is only available in the Retailer Portal.

As long as you don’t use a mobile device management software, we recommend using the Play Store to get automatic updates in a convenient way.

Initialization of a POS installation​

If you start the POS application right after installation you will see one of the screens above, asking for a configuration. A configuration associates the local installation with a device in the snabble backend. It contains the merchant, store and pos numer. Depending on your device, the configuration can be provided by choosing a config file or by scanning a QR code containing the config.

On mobile phones and handheld devices the configuration can be scanned by camera or build in scanner.POS welcome screen
On other POS devices, the configuration can be read from a file or by scanning the QR code with a attached scanner. POS welcome screen

Reset a POS installation​

If you want to reset a POS installation, you have to remove the configuration. This can be done in the 'Device' section of the config menu of the POS application.

This is for example useful if you want to use the same hardware in a different store.

Device administration​

Device creation in Retailer Portal​

Before you use a POS device, you have to create the virtual device configuration in the Retailer Portal.

Device list menu in retailer portalNavigate to Devices -> Device List .
Device list in retailer portalYou see a list with all devices for the merchant. A New device can be added with ADD DEVICE.
Create a new POS deviceSelect a Store and type in any name which is meaningfull for you.

Dependant on you use case select POS or SCO as device type.

The External ID is your POS id, which will be refrenced in all exports and reportings.
Download device configAfter device creation, the device configuration is displayed for download. You can download it as file or as QR code and use it for initialisation, as shown in the next paragraph. The configuration is only shown once! If you don't save it, you have to reset the device secret afterwards, which will invalidate an old configuratoin.

Device Configuration in Retailer Portal​

The configuration options of a device can set on different levels: A global level and a configuration for an individual device.

Global device configuratoinAccess the global device configuration options.
Individual device configurationAccess the individual device configuration options in the device list.

Local configuration menu​

The inidividual configuration of a device can also be accessed in the local config menu of the POS or SCO.