Hardware Integration GuideSystem Ready

Pixel Point Hardware Agent Installation & Pairing

Connect thermal receipt printers, barcode scanners, cash drawers, and scales to your Pixel Point Cloud POS workspace.

Detected Operating System:Ubuntu / Debian Linux

We have automatically selected the recommended installation instructions and package for your current machine.

Step 1: Download & Install Hardware Agent

The Debian/Ubuntu package installs the agent executable to /usr/bin/pixelpointagent and automatically registers a systemd background service (pixelpointagent.service) that runs on boot.

Download pixelpointagent_1.0.0_amd64.deb
Terminal Installation Commands
cd ~/Downloads && sudo dpkg -i pixelpointagent_1.0.0_amd64.deb

# Verify service status
sudo systemctl status pixelpointagent.service

Step 2: Generate Agent API Key

To bind your local terminal machine to your organization, generate a secure API Key from the Back Office console:

  1. Go to System Setup → API Keys in the navigation sidebar.
  2. Click Generate New Agent Key.
  3. Select your target Branch Location.
  4. Copy the generated API Key string to your clipboard.
Go to API Keys Console

Step 3: Complete Local Agent Pairing Wizard

Once the background service is running on your local machine, complete initial pairing via the local setup wizard:

Local Agent Address
http://127.0.0.1:8765/setup

Enter your Organization ID and paste the API Key copied from Step 2 to finish configuration.

Open Local Setup Wizard