What is the Treez Hardware Agent?
The Treez Hardware Agent is a standalone Windows desktop application designed to securely connect your dispensary’s critical hardware devices, such as receipt printers, label printers, and flatbed scanners, to the Treez POS system.
This new agent replaces the legacy Hardware Agent with improved security, device management, and usability features.
Why the New Hardware Agent?
Enhanced Security: Requires authenticated login to prevent unauthorized access and ensure compliance with SOC standards.
Automatic Device Detection: No need to manually scan for new devices in the web portal. Set up your hardware with your Windows machine, and the app will detect it automatically.
Improved Print Job Handling: Supports unlimited label print jobs without early expiration.
Seamless Updates: Automatically checks for and installs updates with minimal disruption.
Better Support & Logging: Easier troubleshooting with enhanced error logs that can be shared with Treez Support.
Multi-Store Access: Single user login allows access to multiple stores within the same organization.
Supported Hardware Devices
Receipt Printers
Label Printers (one per print location)
Flatbed Scanners
Note: The new Hardware Agent supports the same devices as before, with expanded driver compatibility for newer models.
Installing the New Hardware Agent
For detailed setup instructions: SellTreez: All About Configuring New Hardware
Click this link to download - Hardware Agent Installer
Find the download called 'TreezDesktop.msix'
Run the installer on your Windows PC.
Launch the application
Search for 'Treez Desktop' in your applications
Look for the gray and green Treez icon in the taskbar
Sign in with your Treez credentials.
Select your store and the appropriate print location.
Print locations must be created in the Treez web portal under Configuration page > Config Page > Hardware. Note: It is not necessary on this page to scan for devices and update the device dropdowns.
Connect your hardware devices to the PC. These must be visible in Windows Settings > Devices > Printers & Scanners.
The app will auto-detect devices and populate the dropdowns for device assignment. Select the appropriate devices in the dropdowns.
Select the printer icon next to the dropdown to complete a test print within the app to confirm proper setup.
Using the New Hardware Agent
Similar to the legacy hardware agent, the new app runs in the background and must be open to manage connected hardware.
In the Treez web portal, confirm the selected print location dropdown to send print jobs or scanned documents to the devices configured in the app for that print location.
Devices are automatically detected at launch and when connected to the PC. There is no need to scan for new devices in Configurations > Config Page > Hardware.
You can perform test prints or scans directly from the app for verification.
The app will check for updates every time it starts and will install available updates automatically without intervention.
If the app is already running, it checks for updates hourly and prompts you with a dismissible notification.
Select the PIN icon in the upper right corner to pin to your taskbar for easy access
Use the lock icon in the upper-right corner to prevent unintended changes to the app configuration
Frequently Asked Questions
Q: Do I need to uninstall the old Hardware Agent?
A: No, the old and new Hardware Agent apps can coexist on the same machine. However, uninstalling the old app is recommended to avoid conflicts. The old app cannot connect to a print location already in use by the new app. While the new app doesn’t prevent multiple PCs from connecting to the same print location, running different device configurations on multiple PCs for the same location can lead to unexpected behavior. A future update will automate uninstalling the old app when the new app is installed.
Q: Will the old Hardware Agent app be deprecated soon?
A: Yes, the old Hardware Agent app will be deprecated eventually, but no specific timeline has been announced yet. For the best performance and to avoid any disruptions, we recommend downloading and using the new Hardware Agent app on all PCs that connect to printers and flatbed scanners with Treez.
Q: Can I use the new Hardware Agent on macOS?
A: The new agent supports Windows only.
Q: Do I need to create new print locations in the Config Page for the new Hardware Agent?
A: No, the existing print locations you’ve configured can continue to be used with the new Hardware Agent app. There’s no need to create new locations.
Q: How do I add a new print location in the portal?
A: In the Treez portal, go to Configuration > Config Page > Hardware > Add Location, then enter a simple, descriptive name (avoid special characters like slashes). This location will be used in the app to assign devices.
Q: How do I reset the Hardware Agent app?
A: On the old app, resetting the app involved logging out to enable changing the store and print location. In the new app, you can simply update the store or print location directly from the dropdown menu without needing to log out. If you prefer, you can still choose the logout option to reset the app manually.
Q: How do I update the new Hardware Agent app?
A: The new agent automatically checks for updates every hour in the background and will prompt or apply updates on startup as needed.
Q: What should I do if my printer is not printing receipts or labels?
A: First, ensure the Hardware Agent app is running and connected to the correct store and print location. Try performing a test print directly from the app. Confirm that the same print location is selected in the Treez web portal. Next, check your Windows printer settings and run a test print from Windows itself. If the Windows test print works, make sure the correct printer is selected in the Hardware Agent app’s printer dropdown. If problems persist, log out of the Hardware Agent app and log back in to reset the connection.
Q: I have two label printers to print 2x1" labels and another for .5x.5" labels that are connected to the same print location today. How can I set this up on the new agent?
A: Currently, the new agent only supports one label printer type at a time. You can switch between the selected printers in the app's label printer dropdown as needed or run a separate agent on a different PC connected to the label printer.