This project is on hold due to a cancelled partnership agreement with our firmware provider. The below is kept in the event we can create our own firmware and bring this product back to life.

Portable, sandboxed devices (such as iPads, iPhones, Android Tablets, Android Phones and Chromebooks) historically have strict requirements for secure-communication to QZ Tray, but this has been historically challenging to support in the field.

• QZ Surf has a small-footprint, yet runs a full-blown instance of QZ Tray, offering 100% feature-parity with the Desktop version.
• To connect to a QZ Surf box, please ask your app team to add a new connect option. Your box has a name, such as orca printed on the top of the box. You'll need this name to connect to it.
• For most devices, QZ Surf is plug-and-play. If your device doesn't show up, scan the QR code on the top of the QZ Surf box and click the "Add CUPS Queue" link.

The interface is a familiar configuration screen with the details that matter most such as uptime, resource usage, network information, printer info, USB devices and QZ Tray status.

Wi-Fi setup is as simple as selecting your network and typing your password.

QZ Surf is powered by a Raspberry Pi 5 8GB model running Raspbian (Debian) OS on ARM64 architecture.

💡 NOTE: Hardware specifications are subject to change

QZ Surf works by binding an address (e.g orca.qz.surf) to your local network and receiving a certificate for secure communications. This requires:

• Connectivity to a certificate authority server (e.g. LetsEncrypt)
• Connectivity to a DNS registrars (e.g. Cloudflare)

Integration is as simple as providing your users a name field to connect to.

💡 Note: If you already have a QZ Surf box, you can test your connection right now by visiting https://demo.qz.io and clicking the down arrow on the "Connect" button.

Are you the app developer? That's simple too!

// Each QZ Surf box has its own unique name
- qz.websocket.connect();
+ qz.websocket.connect({ host: "orca" }); // qz-tray@2.2.6+

💡 Note: If you're a developer, the code is as simple as adding the host parameter to your qz.websocket.connect() call.

QZ Surf is available in limited quantities during a beta rollout in the second quarter of 2026. Please inquire at sales@qz.io for pricing and availability.

Compatibility with websites will depend on cooperation from your website maintainer.

QZ was working with a 3rd party firmware provide that's recently backed out, this project is on hold until further notice.