Installation and updates

Installing the Postman app

Postman native apps

Postman is available as a native app for macOS, Windows, and Linux operating systems.

To install Postman, go to the apps page and click Download for macOS / Windows / Linux depending on your platform.

Postman apps page

macOS installation

Once you’ve downloaded and unzipped the app, double click on Postman. You will be prompted to move file into the "Applications" folder. Click "Move to Applications Folder" to ensure future updates can be installed correctly. The app will open after the prompt.

Move to Applications Folder

Windows installation
  • Download the setup file
  • Run the installer
Linux installation

For installation on Linux, perform the following steps:

  1. First download and unzip the file

  2. And then create a desktop file by name Postman.desktop. Create the Postman.desktop file in the following location:

    ~/.local/share/applications/Postman.desktop

Use the content below in the above file:

[Desktop Entry]
Encoding=UTF-8
Name=Postman
Exec=YOUR_INSTALL_DIR/Postman/app/Postman %U
Icon=YOUR_INSTALL_DIR/Postman/app/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;
 

Once the Postman.desktop file is created, the Postman app can be opened using application launchers. You can check your desktop and double-click the Postman icon.

Note:

  1. Avoid starting postman using sudo command, this will create permission issues on the files created by postman.

  2. Make sure you have read/write permission for ~/.config folder where Postman stores the information

  3. If you are an Ubuntu 18 user, you must additionally install libgconf-2-4 package to ensure a smooth Postman run. This package, shipped by default until Ubuntu version 18, has been dropped, and is mandatory for Postman to run. Use the following command to install libgconf-2-4:

apt-get install libgconf-2-4

Supported Platforms

This section describes the additional software and infrastructure you'll need to run Postman. Please review this info before installing Postman. You should only use Postman with a supported platform. Any platforms and versions not listed on this page are unsupported, which means we don't test, fix bugs or provide assistance.

macOS

The minimum version supported is macOS 10.9.

Windows

Postman supports Windows 7 and above. Older operating systems are not supported.

Both ia32 (x86) and x64 (amd64) installers are provided for Windows. Note that the ARM version of Windows is not supported.

Linux

Postman supports the following Linux distributions:

  • Ubuntu 12.04 and later
  • Fedora 21
  • Debian 8 and later

Note:Note: If you are an Ubuntu 18 user, you must additionally install libgconf-2-4 package to run Postman. This package, which was shipped by default until Ubuntu version 18 has been dropped, and is mandatory to run Postman. Use the following command to install libgconf-2-4:

apt-get install libgconf-2-4

Postman Chrome app

We recommend using the Postman native apps, but Postman is also available as a Chrome app. Read more about why support for the Postman Chrome app is being deprecated.

The Postman Chrome app can only run on the Chrome browser. To use the Postman Chrome app, you will first need to install Google Chrome.

If you already have Chrome installed, head over to Postman’s page on the Chrome Web Store, and click ‘Add to Chrome’.

The download should take a few minutes depending on your internet connection. Once you’ve downloaded the app, you can launch Postman.

Differences between Chrome and native apps

Postman’s native apps are built on Electron, and overcome a number of restrictions of the Chrome platform.

A few features exclusive to the native apps are listed here:

Cookies

The native apps let you work with cookies directly. Unlike the Chrome app, no separate extension (Interceptor) is needed.

Built-in proxy

The native apps come with a built-in proxy that you can use to capture network traffic.

The native apps are not restricted by the Chrome standards for the menu bar. With the native apps, you can check for updates, create Postman Windows and tabs, edit preferences, and can perform many other tasks.

Restricted headers

The latest versions of the native apps let you send headers like Origin and User-Agent. These are restricted in the Chrome app. 

Don't follow redirects option

This option exists in the native apps to prevent requests that return a 300-series response from being automatically redirected. Previously, users needed to use the Interceptor extension to do this in the Chrome app.

Postman console

The latest version of the native app also has a built-in console, which allows you to view the network request details for API calls.

Migrating to the native app

It’s simple.  Sign in to your Postman account after you download and start the new native app, and all your history and collections will be automatically synced.

Alternatively, if you don't want to sign in to your Postman account, you can bulk export your Postman data from the Chrome app, and then bulk import into the new native app.

import data

Bulk export

From the Postman settings, select the Data tab and click the Download button to export all your collections, environments, globals and header presets to a single dump file.

Bulk import

From the same area in Postman settings, you can initiate a bulk import from a Postman data dump file. This will overwrite your existing data so be careful.

Updating Postman

Native app (macOS, Windows and Linux)

Postman's native apps will notify you whenever a major update is available. Other updates are indicated by an indicator that appears on the settings icon. If the indicator is red instead of orange, it indicates a failed update.

settings update indicator

Click Update to download the latest update. You will be notified when the download is complete prompting you to restart the Postman app to apply the updates. If you're not ready to update yet, click Later to auto update after the next app launch.

You can also configure your preferences to enable automatic download for major updates under the Update tab within the SETTINGS modal. Postman automatically downloads minor updates and bug fixes.

set automatic updates in settings

Troubleshooting Postman Updates*

Some users may encounter issues updating in the Windows version of Postman 6.1. To resolve you must set the environmental variable POSTMAN_DISABLE_GPU=true. In order to do this, follow these steps:

  1. Open Advanced system settings
  2. Navigate to Environment Variables
  3. Add a new system variable and save by click 'OK'.

step 1

step 2

step 3

Chrome

Postman’s Chrome app is usually updated automatically. However, Postman doesn't control the Chrome app update flow, and Chrome sometimes doesn’t update the app for long periods of time.

The latest version is visible on Postman’s Web Store listing.

To manually force an update, here’s what you need to do in Chrome:

  1. In the address bar, type chrome://extensions.
  2. At the top of the page, check and enable Developer Mode.
  3. Click the Update extensions now button beneath Developer Mode.

Chrome developer mode