IPP over TLS (IPPS) port closed — open 631 and test with curl
Joe B.
Reviewed for technical accuracy
Specialities: Windows 11/10, macOS (Sonoma/Ventura/Monterey), CUPS/IPP/IPPS, Networking, Office Equipment
IPPS (IPP over TLS) not working — port 631 closed or filtered on Windows, macOS, Linux, CUPS, HP, Epson, Canon, Brother
Quick answer: the accepted fix
Accepted fix when IPPS (IPP over TLS) not working or port 631 is closed:
Allow TCP/631 in the firewall, ensure CUPS/Print Server listens on 631 with DefaultEncryption=Required,
install a valid certificate (or trust your CA), and test with curl/ipptool using the correct
ipps://host:631/printers/QUEUE URI.
IPPS fails after updates — TLS or firewall changed (Windows/macOS/Linux)
Updates can tighten TLS policies or switch drivers. Re-check that port 631 is open, CUPS still has
Listen *:631 configured, and the certificate is valid (CN/SAN and expiry). On Windows, re-enable inbound rules or group
policy allowing IPPS. Re-add the printer using ipps:// rather than LPD/RAW to enforce encryption.
How to verify IPPS end-to-end
Run curl -vk ipps://host:631/printers/QUEUE and expect a response (403/401/200). Then use
ipptool -tv to fetch attributes. From Windows, Test-NetConnection -Port 631 confirms reachability; on Linux,
ss -ltn | grep :631 proves the listener. If TLS fails, import the CA certificate on each client and retest.
IPPS — troubleshooting tips
Most IPPS issues are firewall blocks, wrong IPP path, or certificate trust.
Quick path: open 631/tcp → set Listen *:631 in cupsd.conf → enable DefaultEncryption → verify the
ipps:// URI and certificate → test with curl and ipptool. For embedded printers (HP/Epson/Canon/Brother),
enable IPP/IPPS and upload a cert that matches the hostname used by clients.
Disclaimer: This information is AI-generated and intended for general guidance only. For advice specific to your environment, please consult a verified expert on Whizz-Tech before making decisions.
Getting Started Is Easy
Ask for help, 24/7
Members enjoy round-the-clock access to 12,000+ verified Experts, including tech support, mechanics, vets, and more.
Expert will respond in minutes
We match you with an Expert who specializes in your situation. Talk, text, or chat — whichever you prefer.
Save time & money
No scheduling hassles or expensive consults. Membership can save you significant time and money each month.
FAQ
Why is IPPS (IPP over TLS) not working?
Usually port 631/tcp is blocked by a firewall, CUPS is not listening on 631, the IPP path is wrong, or the certificate is untrusted/expired. Open 631, set Listen *:631, use the correct ipps://host:631/printers/QUEUE URI, and trust the CA.
How do I open port 631 on Linux?
For UFW: sudo ufw allow 631/tcp. For firewalld: sudo firewall-cmd --add-service=ipp --permanent && sudo firewall-cmd --reload. Then restart CUPS and verify with ss -ltn | grep :631.
How do I test IPPS with curl?
Run curl -vk ipps://host:631/ or curl -vk ipps://host:631/printers/QUEUE. A response (401/403/200) confirms 631 is reachable and TLS works. Use ipptool -tv for printer attributes.
Windows 10/11 can’t add the IPPS printer — what now?
Create an inbound firewall rule for 631 if the server is Windows; import the printer’s CA certificate if it’s private; add using the ipps:// URL and choose the vendor driver instead of a generic class driver.
What’s the difference between IPP, IPPS, LPD, and RAW 9100?
IPP is the modern HTTP-based protocol for printing. IPPS is IPP over TLS (encrypted). LPD/515 and RAW/9100 are legacy/unencrypted and often blocked by policy; prefer IPPS for security and compatibility.
| Symptom | Likely cause | Quick fix |
|---|---|---|
| Port 631 closed/filtered | Host firewall/NACL blocking | Allow 631/tcp (UFW/firewalld/Windows) |
| TLS handshake fails | Untrusted or mismatched certificate | Install valid cert; import CA on clients; use correct hostname |
| Jobs fail at submit | Wrong IPP path or auth | Use /printers/QUEUE or /ipp/print; set AuthType; test with ipptool |
| Discovered via AirPrint but can’t add | _ipps._tcp off or TLS policy | Enable Bonjour/_ipps._tcp; enforce IPPS; trust certificate |
Step-by-step (Windows 10/11)
- On the server (if Windows): open inbound 631/tcp with
New-NetFirewallRule; on clients, ensure outbound 631 allowed. - Verify reachability:
Test-NetConnection -ComputerName host -Port 631. - Add printer manually using
ipps://host:631/printers/QUEUE; pick the vendor driver. - If using a private CA, import the CA certificate into Trusted Root Certification Authorities.
Step-by-step (Linux/macOS server with CUPS)
- Open the firewall (UFW/firewalld) for TCP 631.
- Enable CUPS on 631:
cupsctl WebInterface=yes,cupsctl --remote-admin --remote-any --share-printers, and confirmListen *:631. - Require encryption:
cupsctl DefaultEncryption=Required; ensure the certificate/hostname is valid. - Restart CUPS, then test:
curl -vk ipps://host:631/andipptool -tv ipps://host:631/printers/QUEUE get-printer-attributes.test.
Sources
- CUPS — IPP/IPP Everywhere documentation
- CUPS Administration (cupsd.conf, cupsctl)
- Ubuntu — ufw manual
- firewalld — documentation
- Microsoft — Create an inbound port rule (Windows Firewall)
- curl — man page
- ipptool — CUPS test tool
Filed under: Printers
Related articles
- Printer says “Offline” and won’t print — what should I check first?
- My printer “forgot” my Wi-Fi — the saved network is gone
- Printer Wi-Fi settings reset by itself — why did it forget my network?
- My printer keeps popping up “Set up Wi-Fi” again — why won’t it stay connected?
- Why does my printer need Wi-Fi setup again? It was working yesterday.
- My printer Wi-Fi setup keeps failing — what am I doing wrong?
- Printer Wi-Fi setup is confusing — why won’t it connect to my network?
- Printer Wi-Fi setup is too complicated — what do I check first without messing it up?