Getting Started

Getting your ProxyBox up and running takes about five minutes. Plug it in, connect to your network, and you’re ready to start printing.

Physical Setup

1. Plug the power adapter into a power source and connect the USB-C end to the ProxyBox.
2. Connect the ProxyBox to your router with an Ethernet cable.
3. Press the power button to turn it on.
4. Wait about 5 minutes for the initial boot process to complete.
5. From another device on the same network, open a browser and navigate to https://pbx-ABCD.pbxz.io (replace ABCD with the 4-character ID on the sticker on your device).

Note

The device ID is printed on a label on your ProxyBox. It’s a 4-character alphanumeric code (e.g. D8A4, JRDN). You’ll use this ID in every URL that references your device.

First Login

You’ll see a password prompt. Enter the random password printed on your device label. It has the format XXXX-XXXX-XXXX, including the dashes. The same password is recorded in the provisioning manifest.

Caution

Change the default password immediately after your first login.

Change Your Password

Open Settings. Under Password, enter a password of at least 8 characters in New password… and enter it again in Confirm new password…. Select Update Password.

The page confirms the change and keeps your current browser session signed in. Every other session is logged out.

The Admin Dashboard

After login you’ll land on the admin page, which shows all available modules — printers, tags, proxy URLs, settings, and extensions.

Header Bar

The header displays:

Field	Description
Release Version	The release version currently running on the device.
IP Address	The device’s local IP address.
Hostname	The device’s hostname.
Uptime	Time since the last reboot.

The header also provides a Logout button and a Reboot button. Rebooting will show a confirmation dialog first.

Test Your Connection

Navigate to https://test.pbxz.io to run a quick test against your device.

You’ll be asked for two values:

1. ProxyBox ID — the same 4-character ID from the setup steps above.
2. API Key — use an enabled key from Settings > API Keys. Reveal and copy the key there.

Enter both values and connect. The test page lets you view device status, see discovered printers, and send test prints — confirming everything is working before you integrate with your applications.

Your First API Call

Everything the test page does, your applications do through the REST API. Reveal and copy an enabled key from Settings > API Keys, then try it from a terminal (each ProxyBox ships with an enabled key named Default — the value below is an example):

# Device status
curl https://pbx-ABCD.pbxz.io/api/v1/status \
  -H 'X-API-Key: ULA9WHXMFCHF'

# List discovered printers
curl https://pbx-ABCD.pbxz.io/api/v1/printers \
  -H 'X-API-Key: ULA9WHXMFCHF'

Pick a printer from the response — its path field is the print target — and send a test print:

curl -X POST https://pbx-ABCD.pbxz.io/api/v1/print/tcp_192-168-86-250_9100/test \
  -H 'X-API-Key: ULA9WHXMFCHF'

That’s the whole integration surface: your application makes the same HTTP calls, whether it runs on the local network or anywhere on the internet.

Next Steps

• Tags — print to a role like tag_LABELS instead of a hardware path, so you can swap printers without changing code. Worth adopting from day one.
• Printer Guides — format requirements and tips for Zebra, Brother, Epson, and office printers.
• API Reference — the full print API: content types, print options, job tracking.