'Unable to connect to server' error when starting client
Tip: If you’re seeing mysterious behavior with the User Client, but not getting any error messages, check to see if the User Client has been configured to use the —silent option, which suppresses all error messages. Try running the client without this option, and see if the client then gives you any useful error message information first!
Note: if you’re seeing this message, but you know that it’s not able to connect because you’re not on the same network as your server, then take a look at the Suppress Error Notifications when offline article. This applies if e.g. you take your laptop home with you, and you don’t want to be bugged with ‘unable to connect’ messages.
Unable to connect to the server: unable to establish connection with the server: papercutserver
Problem communicating with server: Operation timed out (Connection timed out)
You may also see a ‘Connecting…’ status if you hover over the PaperCut user client icon in the Windows task bar or macOS menu bar:
Check to see if the App Server is started, and if not, try restarting the App Server.
Check the config.properties file to make sure that the server-ip and server-name lines are correct. They should show a valid IP address and hostname for your Application Server. If you’ve recently migrated your PaperCut server then you’ll need to update the connection details for the clients.
The local copy of the
config.properties file can be found in one of the following locations on a workstation, assuming a default install path.
- Windows -
C:\Program Files (x86)\PaperCut MF (or NG) Client\config.properties
- macOS -
PCClient.app can be opened like a folder by right-clicking it and choosing to Show Package Contents
config.properties file can be found in one of these locations on the primary Application Server, where
[app-path] is the install path of the Application Server component.
- Windows -
- macOS -
Ideally you’ll have a static IP address set up for your Application Server, so that the connection details remain the same.
If you’re using a Firewall in between clients and the Application Server, take a look through the Firewall Ports page to see what ports need to be opened for PaperCut to work.
As a test, open a browser Window on the client and try navigating to http://
If you’re running Windows, double check the Windows Advanced Firewall rules to make sure that the network profile (Domain/Work, Private, Public) of the network interface matches how the rule is configured. We have heard of situations where a server is restarted after Windows updates and suddenly the network type switches from the Domain Profile (less restrictive) to Private Profile (more restrictive) and the different Firewall rules prevent the PaperCut client from connecting.
There’s more information here on Forcing SSL, however if port 9192 or 443 isn’t open, or if you don’t have a trusted certificate installed, then the client won’t be able to connect. A good test is to navigate to https://
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.
Keywords: error connecting client , client error , trying to start client , start client
Last updated December 20, 2022