Friday, 30 December 2016

How to configure Postman Native Client App to use an external proxy

TLDR; to configure Postman native client app to use a proxy: use Settings to configure specific or global proxy or start it with command line parameter -proxy-server=host:port

This post updated 20170911 to describe the new Settings options in Postman to configure the Proxy.

postman.exe --proxy-server=localhost:8888

One of things I like about Postman Chrome App is that, because it uses Chrome, it is really easy to feed through a debug proxy like Fiddler, or Zap, etc. etc.

But since Chrome Apps are going to die and Postman has a native app now, I thought I’d use that.

What about an external proxy?

  • Previous versions of Postman only supported configuration of the proxy from the command line - see below.
  • Then Postman supported “System Proxy” Proxies e.g. Fiddler, or Charles which intercept all networks traffic automatically
  • In version 5.2.0 Postman introduced actual Proxy configuration settings
Go to “File \ Settings” and Select “Proxy”
Then you can Toggle between:
  • no proxy (both global and system set to Off)
  • Global Proxy Configuration (use a specific ip address and port to proxy requests)
  • Use System Proxy (use the current operating system proxy settings e.g. Fiddler, or Charles automatically)

To use the command line, the Answer Is…

And the answer is that since Postman is an electron based application we can use the electron command line switches.

Here’s how I do it on Windows.

I have a short cut with the target:

C:\Users\Alan\AppData\Local\Postman\app-4.9.3\Postman.exe --proxy-server=localhost:8888

OR I could go to the postman directory and run the command:

postman.exe --proxy-server=localhost:8888

Update 17/8/2017 - on YouTube David Porter left a comment about using this approach on a Mac: `open /Applications/ --args --proxy-server=localhost:8888`

Hope that helps.


  1. Hey Alan, thanks a bunch for this. You saved my day! Exactly what I was looking for. I had been using Postman as a Chrome app on Windows and Chrome depends on Windows internet connection settings for its proxy so it was a real pain to have to change those settings every time. But with this, I can just limit the proxy use to just Postman and change it any time I want. Awesome man! Thanks again. :-)

    1. You're welcome. Thanks for letting me know. Glad it helped :)

  2. Thanks this really helped me, as you correctly said this wasn't corrected documented anywhere so great work finding this!

  3. In my windows native postman installation I do not see any Postman.exe, looks like it uses Update.exe to start postman. How can I pass the command line parameter. Following is used to start Postman.
    C:\Users\username\AppData\Local\Postman\Update.exe --processStart "Postman.exe"
    If I try to pass the parameter postman does not start.
    C:\Users\username\AppData\Local\Postman\Update.exe --processStart "Postman.exe --proxy-server=localhost:8888"

  4. In the properties dialog - where you found the command line - look at the target folder, that is where Postman.exe is installed.

    Or just look in your `C:\Users\username\AppData\Local\Postman` for the `app-x.x.x` directory

    Or in `C:\Users\username\AppData\Local\Postman` in explorer search for `Postman.exe`

    1. Now, I am getting authentication error as my proxy requires authentication. To set the proxy I used.

      postman.exe --proxy-server=myproxy:8090

      I get "Error: tunneling socket could not be establish, statusCode=407"

      I also tried following
      postman.exe --proxy-server=userName:password@myproxy:8090

      In this case it does not even set the proxy properly. Proxy gets set to "http://"
      I will appreciate any pointers.

    2. I'd try having a local proxy setup and point postman through that. I'd start with a debug proxy like Fiddler or Charles. That way you can debug the traffic and there are better downstream proxy configuration options in those proxies.

  5. Hey Alan, Thanks for sharing this.
    On Windows 10, trying to capture Postman traffic inside JMeter but not able to, even after running this command. Tried to capture through Fiddler and it worked.
    It turns out that Fiddler creates a proxy at system level as I can see the Proxy server checkbox ticked when Fiddler is running so it does not depend upon `Postman.exe --proxy-server=address:port`
    I verified it by running `Postman.exe --no-proxy-server`
    Still Fiddler is able to capture the traffic.
    So that puts a question mark on the effectiveness of above command.
    Struggling with this scenario, any help is greatly appreciated.

    Thanks in advance,

    1. Hi,

      Yes, Fiddler should work at System Proxy level - as should Charles.

      I just upgraded to Postman 5.0.0 on Windows and Mac and this proxy setting still works for me as documented above.

      I have not tried JMeter Recording.

      To investigate I'd suggest ruling out any issue with JMeter Recording configuration first:

      - make sure JMeter recording is working by changing Firefox to point through JMeter and record traffic from Firefox

      Get a non-system hook proxy like BurpSuite or OWasp Zap running

      - point Firefox at this proxy and make sure you can see traffic

      Then check your Postman command

      - check the validity of your postman command by pointing it at a proxy that is not hooked in at a system level e.g. BurpSuite or Owasp Zap.

  6. Fiddler ha a nice and default option in the connection tab: "act as system proxy at startup". This is not easy to achieve in Postman and right now I'm switching back to Fiddler.