I'm having trouble with the Desktop Agent

View as Markdown

You are experiencing one of the following issues

  • The Desktop Agent keeps running, but the application doesn’t open.
  • I am getting the error Desktop Agent Unavailable when I want to select Send.
  • The Desktop Agent is disconnected.

Unblock yourself

  • In the Postman Web app, make sure you have selected the Desktop Agent.
  • Make sure you have downloaded the latest version of the Desktop Agent and that it is running.
    • To do so, look for the Postman icon on your desktop’s menu bar. The menu should show that the Desktop Agent is connected .
  • If you’re considering using the Desktop app, make sure you’re downloading the correct file on the download page . Select Download the App .
  • Note: You need the Desktop Agent  to use the Postman Web app, which is different from the Postman Desktop app.
  • If the Desktop Agent reads any error, select Check for updates > open the Desktop agent and refresh the web page.
  • Ensure no VPN or proxy is in use that prevents connecting to Postman by allowing all websockets required to work with the Postman application .
  • Note: Try to reproduce the issue on a different network or device to help find the cause.
  • Disable all browser plugins as a test to ensure they do not interfere with the agent connection.

Things to note

  • Chromium-based browsers like Google Chrome, Microsoft Edge, and Brave are preferred.
  • Choose an Agent as per your API testing environment.
  • The Desktop agent doesn’t run behind a proxy.
  • The Desktop agent listens to port 10533.

Still need help?

Submit a support request and include the following information:

  • Whether or not you can replicate the issue with another device.
  • A copy of the Desktop agent logs.
    • To find them, go to the menu bar, select the Desktop agent icon, and then select Developer > View logs.
  • A copy of your HAR files recorded while you are switching agents in the Web application.

Have more questions? Submit a request