Disable firewall entirely?
No—add allow rules instead.
Windows firewall & print client troubleshooting
Firewall or security suites on Windows 10/11 may block local WebSocket to the print client.
Common symptoms
| Symptom | Check |
|---|---|
| After fresh install | Allow exe through firewall |
| Domain PC | IT policy on loopback |
Troubleshooting steps
- Allow app in Windows Defender Firewall
- Confirm client listens on 127.0.0.1
- See WebSocket guide
- Windows deployment
Prevention
- Installer prompts to allow firewall
- Enterprise GPO rules
Read next
FAQ
Allow 127.0.0.1 loopback?
Some AV still blocks—allow the exe.
Windows Server RDP?
Install/start client inside user session.
Mac firewall?
See mac-deploy—not covered here.
Verify fixed?
getConnectStatus true, then preview printHtml.
Client deployment by platform
The same web-print-pdf front-end runs on Windows, macOS, and Linux/domestic OS—install the matching client on each desktop.