Please note: Depending on your country and on your selected xentral package, the availability of modules and features differs - thus, the features described in this article might not be part of the xentral product you are using.
Table of Contents
The adapter box is a small server that serves as a connector between xentral and hardware. To connect xentral with the external device (label printer, scale, receipt printer, cash register displays etc.) you need a small "intermediate server" (adapter box), which you can buy, for example here: https://www.elv.de/raspberry-pi-3b-starter-set-mini-pc-komplett-montiert-und-betriebsbereit.html.
For technical reasons, a Raspberry Pi up to version 3B is currently required.
Configure adapter box
Once you have purchased the adapter box, you can configure it with the following steps:
Step 1: Connect the adapter box to a monitor and keyboard and mouse. Also, make sure that you have an Internet connection.
Step 2: Install the operating system and confirm the following message with OK.
Step 3: Navigate to LX Terminal (taskbar dark icon) and enter the following commands. Then confirm each with the ENTER key:
sudo apt-get --yes install libcurl3 php7.0-curl php7.0-cli php7.0-xml
sudo usermod -a -G lpadmin pi
sudo systemctl enable ssh
sudo dpkg -i adapterbox.deb
echo "Seriennummer eingeben gefolgt von einem [ENTER]:"
echo "<?php \$config['serial'] = '$seriennummer'; ?>" > /tmp/config.php
sudo mv /tmp/config.php /root/config.php
With the exception of the last call, the echo commands are for illustrative purposes only.
Important: You can download the Debian file (deb file) for the wget command from the GitHub download directory.
If the execution of the script does not work, you may need to install and activate the PHP version and extensions.
sudo apt -y install php php-common
sudo apt -y install php-cli php-fpm php-json php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath
Wait until you are prompted to enter a serial number. Enter a 9-digit number and confirm with the ENTER key - this serial number will be used later in xentral. The box will switch off automatically. After that the adapter box is configured and you can start with the next step.
Note: If your printer does not print, change the driver from cpcl to zpl (Zebra zb 230). More information can be found on these pages: