Configuring PaperCut NG/MF to use a proxy

“Help! All our outbound network traffic is funneled through proxy, and we’re having trouble setting up some features. What do we need to know, and how can we configure PaperCut NG/MF to work with our proxy?” When should you configure PaperCut NG/MF to work with a proxy? Having trouble getting certain features to work that require a connection to the internet? If your organization uses a proxy, you may need to configure PaperCut NG/MF with the right details first. These specific PaperCut NG/MF features require an internet connection and may not work properly if outbound network traffic must first pass through a forward proxy: Scan to Cloud Storage Document Processing (OCR) Mobility Print’s Known Host option (to sign the iOS profile) Google Cloud Print Automatic updates Universal Print Connector Global Entitlement Server (GES) Configure a proxy with PaperCut NG/MF Log into your PaperCut NG/MF administrator console and open the Advanced Config Editor by browsing to Options → Actions → Advanced Config Editor. Search for the config keys containing system.network-proxy. Update these Config Keys with the relevant details for your proxy: system.network-proxy-address system.network-proxy-password system.network-proxy-port system.network-proxy-user Once the details are updated, restart the PaperCut NG/MF Application Server service for the changes to take effect. If things are still not working at this stage, check our Firewall Ports article to see if there are any ports or URLs that you must allowlist on the proxy to get the specific PaperCut NG/MF feature to work. Configure a proxy with PaperCut NG/MF using Server commands Can’t access the Advanced Config Editor in the admin console? You can still configure your proxy settings using the server-command tool. Here’s how: If running Windows, click the Start menu, then type cmd. In the search results, right-click Command Prompt, then select Run as administrator. In the Command Prompt window, change to the directory where the server-command.exe tool is located - [app-path]\server\bin\[OS]\. For example, if running PaperCut MF on a 64-bit Windows server, the command should be: cd "C:\Program Files\PaperCut MF\server\bin\win" Use the following commands to set your proxy address, port, username, and password. Replace the values, including the angle brackets, with your actual proxy info. For example, if your proxy address is proxy.papercut.com, you’d run: server-command set-config "system.network-proxy-address" "proxy.papercut.com". server-command set-config "system.network-proxy-address" "<your proxy address>" server-command set-config "system.network-proxy-port" "<your proxy port>" server-command set-config "system.network-proxy-user" "<your proxy username>" server-command set-config "system.network-proxy-password" "<your proxy password>" Heads up These are just example values. Check with your network team to make sure you’re using the right ones. Once you’ve updated the settings, restart the PaperCut NG/MF Application Server service so the changes can kick in. Configure a proxy with Universal Print With the release of Universal Print Connector version 2025-02-17-2017 and later, you can now configure it to work with a proxy. Follow these steps to configure the Universal Print Connector to work with a proxy: Stop the PaperCut connector for Microsoft Universal Print service. On the PaperCut server where the print queues are hosted, navigate to: C:\Program Files\PaperCut MF\providers\universal-print\win\. Using a text editor with local admin rights, open the file http-proxy.conf Add a line to include your proxy’s host and port host:port. Which will look like this: 127.0.0.1:8888. Alternate valid configurations include: http://user:password@host:port https://user:password@host:port user:password@host:port Restart the PaperCut connector for Microsoft Universal Print service. Have multiple PaperCut servers such as Site Servers or Secondary Servers? Keep in mind you’ll need to repeat the above steps on each server where printers are being shared. If you do not want the Secondary Server communication between Universal Print Connectors to be proxied, then you can make an exception for this (on each Connector) by modifying the Universal Print Connector configurations: Stop the PaperCut connector for Microsoft Universal Print service. Navigate to C:\Program Files\PaperCut MF\providers\universal-print\win\data\conf\ Using a text editor with local admin rights, open the file pc-upconnector.conf Modify the line with key, "StopProxyInterConnectors" and change its value from false to true. Restart the PaperCut connector for Microsoft Universal Print service. Unsupported proxy PaperCut components Email to Print Found occurrences in OAuth and Azure specifically that do not work with a proxy enabled PaperCut Mobility Print and proxy support At the moment proxy configurations are not supported with PaperCut Mobility Print. This is not a problem if you are using the mDNS or DNS-SD discovery methods, but is a problem if you are configuring the Known Host discovery method which requires an internet connection to get the latest installers and sign profiles for iOS clients. If this is a requirement for your organization, please reach out to the support team and mention “MOB-1752” which is the code we use to track demand for this feature. Still have questions? Let us know! We love chatting about what’s going on under the hood. Feel free to leave a comment below or visit our Support Portal for further assistance.