LinkBox Cross-Platform Alternative PosBox System



v 8.0 v 9.0 v 10.0 v 11.0 v 12.0 Third Party 3
Required Apps Point of Sale (point_of_sale)
Sales Management (sale)
Invoicing (account)
Inventory Management (stock)
Technical Name linkbox
Also available in version v 10.0 v 11.0 v 8.0 v 12.0
You bought this module and need support? Click here!
Required Apps Point of Sale (point_of_sale)
Sales Management (sale)
Invoicing (account)
Inventory Management (stock)
Technical Name linkbox
Also available in version v 10.0 v 11.0 v 8.0 v 12.0


Cross-Plaform Alternative PosBox System

Key features:
  • Cross-Platform and Easy Installation
  • Single Executable File
  • No PostgreSQL required
  • No Additional Hardware (like Raspberry Pi) required

How Setup LinkBox

Before connected LinkBox to Odoo you need to setup LinkBox based on OS distribution you used. Also, you need to understand that LinkBox is running under libusb. Here step-by-step that you can follow.


    There is no libusb installation for Ubuntu because Ubuntu already comes with libusb, but you need to create an access right for the usb system. You can follow the following procedure:

  • Open Terminal and run command bellow:
  • sudo groupadd usbusers
    sudo usermod -a -G usbusers USERNAME
  • Then we need to create a udev rule that will automatically allow members of usbusers to access raw USB devices. To do so create a file called 99-usbusers.rules in the /etc/udev/rules.d/ directory with the following content:
    SUBSYSTEM=="usb", GROUP="usbusers", MODE="0660"
    SUBSYSTEMS=="usb", GROUP="usbusers", MODE="0660"
  • Then you need to reboot your machine.


    For the libusb installation on Mac OS, you can follow the following procedure:
  • Press Command+Space and type and press enter/return key.
  • Run in Terminal app:
    ruby -e "$(curl -fsSL" < /dev/null 2> /dev/null
    and press enter/return key.
    If the screen prompts you to enter a password, please enter your Mac's user password to continue. When you type the password, it won't be displayed on screen, but the system would accept it. So just type your password and press enter/return key. Then wait for the command to finish.
  • Once the process above complete run these command:
    brew install libusb
    and press enter/return key.
  • Then you need to reboot your machine.


    Before use LinkBox in Windows, you need to create libusb driver for your printer that you used. Open inf-wizard.exe that you can find in folder libusb-win32-bin-\bin\. Then execute the binary with Administrator access. Follow this instruction:
  • Right-click inf-wizard.exe and Run As Administrator.
  • Click on Next to go to the next step.
  • Select your printer, then click on Next.
  • Click on Next to go to the next step.
  • Save your own libusb driver, then click on Save.
  • Click on Install Now.. to install the drivers.
  • Please wait until installation finished.
  • Installation successful!

Run LinkBox

Find the binary file under directory/folder bin and you can execute it with double click. Then after it running successfully, the LinkBox information will be printed.

Also, you will find the LinkBox icon in system tray. The following are screenshot LinkBox on some operating system.

screenshot #1: Ubuntu
screenshot #2: Mac
screenshot #3: Windows

Odoo Configuration

After LinkBox successfully running, you need to configure Odoo POS system. Follow this instruction:

  • Go to Point of Sale >> Configuration >> Point of Sale.
  • Select POS that you want to configure.
  • Open POS configuration form.
  • Click on Edit.
  • Click on LinkBox then the IP connection. By default, the ip and port that LinkBox use is http://localhost:8080.
  • Then tick on Receipt Printer.
  • Click on Save.

Test Print Receipt

Finally, to make sure everything well you need to test Print Receipt. Follow this instruction:

  • Open POS session.
  • Add a product to order, then click on Payment.
  • Add payment and Validate.
  • Then the receipt printer will be printed.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author or have a question related to your purchase, please use the support page.