<commit_before>---
title: "Installing and updating Postman"
updated: 2022-09-02
contextual_links:
  - type: section
    name: "Prerequisites"
  - type: link
    name: "Download and Install"
    url: "https://www.postman.com/downloads/"
  - type: section
    name: "Additional Resources"
  - type: subtitle
    name: "Videos"
  - type: link
    name: "Agent for the Postman Web Client | Postman Level Up"
    url:  "https://www.youtube.com/watch?v=6xlJUx2ZMy4&list=PLM-7VG-sgbtC5tNXxd28cmePSa9BYwqeU&index=3"
  - type: subtitle
    name: "Blog Posts"
  - type: link
    name: "Introducing the Postman Agent: Send API Requests from Your Browser without Limits"
    url: "https://blog.postman.com/introducing-the-postman-agent-send-api-requests-from-your-browser-without-limits/"
  - type: section
    name: "Next Steps"
  - type: link
    name: "Sending your first request"
    url: "/docs/getting-started/sending-the-first-request/"

---

Postman is available on the web at **[go.postman.co/home](https://go.postman.co/home)** and as a native desktop app for Mac (Intel and Apple), Windows (32-bit / 64-bit), and Linux (64-bit) operating systems.

To get the latest version of the Postman desktop app, visit the [download page](https://www.postman.com/downloads/) and select **Download** for your platform.

## Contents

* Installing Postman on the desktop
    * [Mac](#installing-postman-on-mac)
    * [Windows](#installing-postman-on-windows)
    * [Linux](#installing-postman-on-linux)
* [Using the Postman web app](#using-the-postman-web-app)
    * [Browser requirements](#browser-requirements)
    * [Installing the Postman Desktop Agent](#installing-the-postman-desktop-agent)
    * [Web limitations](#web-limitations)
* [Updating Postman](#updating-postman)
* [Chrome app (deprecated)](#postman-chrome-app-deprecated)
    * [Migrating to the native app](#migrating-to-the-native-app)
* [Using Postman behind a firewall](#using-postman-behind-a-firewall)
* [Troubleshooting your Postman installation](#troubleshooting-your-postman-installation)

## Installing Postman on Mac

Postman is available for macOS 10.11 (El Capitan) and later.

1. [Download](https://www.postman.com/downloads/) the latest Postman version.

    > Make sure to download the **Mac Apple Chip** version if you have a Mac with the M1 or M2 processor.

1. If your browser downloads the file as a ZIP file, find the file in the **Downloads** folder and unzip it.
1. In the **Downloads** folder, double-click the `Postman` file to install it.
1. When prompted, move the file to your __Applications__ folder. This will ensure that future updates can be installed correctly.

> You may encounter a "Library not loaded" error if you unzip and install Postman using a third-party archiving app. Use the default Archive Utility for Mac to unzip the file.

You can also install Postman using the [Homebrew](https://brew.sh/) package manager:

```sh
brew install --cask postman
```

## Installing Postman on Windows

Postman is available for Windows 7 and later.

1. [Download](https://www.postman.com/downloads/) the latest Postman version.
1. Select and run the `.exe` file to install Postman.

> Postman v9.4 is the last version of Postman that supports both 32-bit and 64-bit Windows. All versions of Postman following v9.4 will only work on 64-bit Windows. You can continue to use Postman v9.4 and earlier on 32-bit Windows.

## Installing Postman on Linux

You can install Postman on Linux by manually downloading it, using the [Snap](https://snapcraft.io/postman) store link, or with the command `snap install postman`.

To install manually, [download](https://www.postman.com/downloads/) and unzip the app, for example into the `Downloads` directory.

To start the app from a launcher icon, create a desktop file. Name the file `Postman.desktop` and save it in the following location:

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

Enter the following content in the file, replacing `/path/to/Downloads` with the location of the file, and save it:

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

> Postman supports the following distributions:
>
> * Ubuntu 14.04 and newer
> * Fedora 24
> * Debian 8 and newer
>
> The support of certain Linux distributions depends on if they're supported by Electron. Refer to [Electron's documentation](https://www.electronjs.org/docs/tutorial/support#linux).
>
> It's recommended you install [Snap](https://snapcraft.io/postman) as it includes all the libraries that the app needs and they're bundled with the app itself.
>
> Avoid starting Postman using the `sudo` command, as it will create permission issues on the files created by Postman.
>
> Make sure you have read/write permission for the `~/.config` folder where Postman stores information.
>
> If you are an Ubuntu 18 user, you will also need to install the `libgconf-2-4` package with the command `apt-get install libgconf-2-4`

## Using the Postman web app

You can use Postman in your web browser to carry out your API development and testing tasks in conjunction with the Postman Agent. To access the Postman web app, visit [go.postman.co/home](https://go.postman.co/home).

### Browser requirements

The Postman web app is optimized for the following browsers:

* Chrome (78 and higher)
* Firefox (76 and higher)
* Edge (79 and higher)
* Safari (13.1.1 and higher)

### Installing the Postman Desktop Agent

If you are using the Postman web app, you also need to download the Postman Desktop Agent, a micro-application that runs locally on your desktop. The Desktop Agent overcomes the Cross Object Resource Sharing (CORS) limitations of browsers and acts as your agent for making API calls from the Postman web app.

You will be prompted to download and install the Desktop Agent so that you can make requests from the Postman web app. You can also download the agent directly from [the Postman Agent page](https://www.postman.com/downloads/postman-agent/). Once you have the Desktop Agent installed you will be able to use it with web requests.

To learn more about the Postman Desktop Agent, read the [Introducing the Postman Agent](https://blog.postman.com/introducing-the-postman-agent-send-api-requests-from-your-browser-without-limits/) blog post.

### Selecting the agent for requests

From the Postman web app, you can select the agent you would like to use for your requests:

* **Auto-select** - Postman automatically selects the best agent to use for your request.
* **Cloud** - Manually select this option to send HTTP requests using Postman's cloud servers.
* **Desktop** - Manually select this option to send requests using the Postman Desktop Agent.
* **Browser** - Manually select this option to send requests using your browser, with some [limitations](#web-limitations).

<img alt="Select agent" src="https://assets.postman.com/postman-docs/select-agent-for-requests.gif">

> If you send a request and it isn't successful because the agent isn't selected, you can use the provided link in the response area to switch to the agent and send your request again.

### Web limitations

The Postman web app is under active development. There are features you can only access in the Postman desktop app, not in your browser:

* **Find and replace** - The Postman desktop app supports [finding and replacing values in a workspace](/docs/getting-started/navigating-postman/#find-and-replace), but this function isn't available on the Postman web app yet.
* **Certificates and proxy** - The Postman desktop app enables you to customize [certificates](/docs/sending-requests/certificates/) and [proxy configurations](/docs/getting-started/proxy/#configuring-proxy-settings). On the Postman web app, these take the browser defined value and can't be overridden by Postman.
* **Postman Interceptor** - [Interceptor](/docs/sending-requests/capturing-request-data/interceptor/) syncs cookies from your browser to the Postman desktop app and captures network requests directly from the browser. It's not possible to use Interceptor with the Postman web app.

## Updating Postman

The Postman desktop app notifies you when a major update is available. For other updates, there is a dot on the settings icon <img alt="Settings icon" src="https://assets.postman.com/postman-docs/icon-settings-v9.jpg#icon" width="16px">. If the indicator is red instead of orange, it indicates a failed update.

![Update Ready](https://assets.postman.com/postman-docs/update-ready-v86.jpg)<commit_msg>Add Scratch Pad mention to install and update page<commit_after>---
title: "Installing and updating Postman"
updated: 2022-09-02
contextual_links:
  - type: section
    name: "Prerequisites"
  - type: link
    name: "Download and Install"
    url: "https://www.postman.com/downloads/"
  - type: section
    name: "Additional Resources"
  - type: subtitle
    name: "Videos"
  - type: link
    name: "Agent for the Postman Web Client | Postman Level Up"
    url:  "https://www.youtube.com/watch?v=6xlJUx2ZMy4&list=PLM-7VG-sgbtC5tNXxd28cmePSa9BYwqeU&index=3"
  - type: subtitle
    name: "Blog Posts"
  - type: link
    name: "Introducing the Postman Agent: Send API Requests from Your Browser without Limits"
    url: "https://blog.postman.com/introducing-the-postman-agent-send-api-requests-from-your-browser-without-limits/"
  - type: section
    name: "Next Steps"
  - type: link
    name: "Sending your first request"
    url: "/docs/getting-started/sending-the-first-request/"

---

Postman is available on the web at **[go.postman.co/home](https://go.postman.co/home)** and as a native desktop app for Mac (Intel and Apple), Windows (32-bit / 64-bit), and Linux (64-bit) operating systems.

To get the latest version of the Postman desktop app, visit the [download page](https://www.postman.com/downloads/) and select **Download** for your platform.

## Contents

* Installing Postman on the desktop
    * [Mac](#installing-postman-on-mac)
    * [Windows](#installing-postman-on-windows)
    * [Linux](#installing-postman-on-linux)
* [Using the Postman web app](#using-the-postman-web-app)
    * [Browser requirements](#browser-requirements)
    * [Installing the Postman Desktop Agent](#installing-the-postman-desktop-agent)
    * [Web limitations](#web-limitations)
* [Updating Postman](#updating-postman)
* [Chrome app (deprecated)](#postman-chrome-app-deprecated)
    * [Migrating to the native app](#migrating-to-the-native-app)
* [Using Postman behind a firewall](#using-postman-behind-a-firewall)
* [Troubleshooting your Postman installation](#troubleshooting-your-postman-installation)

## Installing Postman on Mac

Postman is available for macOS 10.11 (El Capitan) and later.

1. [Download](https://www.postman.com/downloads/) the latest Postman version.

    > Make sure to download the **Mac Apple Chip** version if you have a Mac with the M1 or M2 processor.

1. If your browser downloads the file as a ZIP file, find the file in the **Downloads** folder and unzip it.
1. In the **Downloads** folder, double-click the `Postman` file to install it.
1. When prompted, move the file to your __Applications__ folder. This will ensure that future updates can be installed correctly.

> You may encounter a "Library not loaded" error if you unzip and install Postman using a third-party archiving app. Use the default Archive Utility for Mac to unzip the file.

You can also install Postman using the [Homebrew](https://brew.sh/) package manager:

```sh
brew install --cask postman
```

## Installing Postman on Windows

Postman is available for Windows 7 and later.

1. [Download](https://www.postman.com/downloads/) the latest Postman version.
1. Select and run the `.exe` file to install Postman.

> Postman v9.4 is the last version of Postman that supports both 32-bit and 64-bit Windows. All versions of Postman following v9.4 will only work on 64-bit Windows. You can continue to use Postman v9.4 and earlier on 32-bit Windows.

## Installing Postman on Linux

You can install Postman on Linux by manually downloading it, using the [Snap](https://snapcraft.io/postman) store link, or with the command `snap install postman`.

To install manually, [download](https://www.postman.com/downloads/) and unzip the app, for example into the `Downloads` directory.

To start the app from a launcher icon, create a desktop file. Name the file `Postman.desktop` and save it in the following location:

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

Enter the following content in the file, replacing `/path/to/Downloads` with the location of the file, and save it:

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

> Postman supports the following distributions:
>
> * Ubuntu 14.04 and newer
> * Fedora 24
> * Debian 8 and newer
>
> The support of certain Linux distributions depends on if they're supported by Electron. Refer to [Electron's documentation](https://www.electronjs.org/docs/tutorial/support#linux).
>
> It's recommended you install [Snap](https://snapcraft.io/postman) as it includes all the libraries that the app needs and they're bundled with the app itself.
>
> Avoid starting Postman using the `sudo` command, as it will create permission issues on the files created by Postman.
>
> Make sure you have read/write permission for the `~/.config` folder where Postman stores information.
>
> If you are an Ubuntu 18 user, you will also need to install the `libgconf-2-4` package with the command `apt-get install libgconf-2-4`

## Using the Postman web app

You can use Postman in your web browser to carry out your API development and testing tasks in conjunction with the Postman Agent. To access the Postman web app, visit [go.postman.co/home](https://go.postman.co/home).

### Browser requirements

The Postman web app is optimized for the following browsers:

* Chrome (78 and higher)
* Firefox (76 and higher)
* Edge (79 and higher)
* Safari (13.1.1 and higher)

### Installing the Postman Desktop Agent

If you are using the Postman web app, you also need to download the Postman Desktop Agent, a micro-application that runs locally on your desktop. The Desktop Agent overcomes the Cross Object Resource Sharing (CORS) limitations of browsers and acts as your agent for making API calls from the Postman web app.

You will be prompted to download and install the Desktop Agent so that you can make requests from the Postman web app. You can also download the agent directly from [the Postman Agent page](https://www.postman.com/downloads/postman-agent/). Once you have the Desktop Agent installed you will be able to use it with web requests.

To learn more about the Postman Desktop Agent, read the [Introducing the Postman Agent](https://blog.postman.com/introducing-the-postman-agent-send-api-requests-from-your-browser-without-limits/) blog post.

### Selecting the agent for requests

From the Postman web app, you can select the agent you would like to use for your requests:

* **Auto-select** - Postman automatically selects the best agent to use for your request.
* **Cloud** - Manually select this option to send HTTP requests using Postman's cloud servers.
* **Desktop** - Manually select this option to send requests using the Postman Desktop Agent.
* **Browser** - Manually select this option to send requests using your browser, with some [limitations](#web-limitations).

<img alt="Select agent" src="https://assets.postman.com/postman-docs/select-agent-for-requests.gif">

> If you send a request and it isn't successful because the agent isn't selected, you can use the provided link in the response area to switch to the agent and send your request again.

### Web limitations

The Postman web app is under active development. There are features you can only access in the Postman desktop app, not in your browser:

* **Find and replace** - The Postman desktop app supports [finding and replacing values in a workspace](/docs/getting-started/navigating-postman/#find-and-replace), but this function isn't available on the Postman web app yet.
* **Certificates and proxy** - The Postman desktop app enables you to customize [certificates](/docs/sending-requests/certificates/) and [proxy configurations](/docs/getting-started/proxy/#configuring-proxy-settings). On the Postman web app, these take the browser defined value and can't be overridden by Postman.
* **Postman Interceptor** - [Interceptor](/docs/sending-requests/capturing-request-data/interceptor/) syncs cookies from your browser to the Postman desktop app and captures network requests directly from the browser. It's not possible to use Interceptor with the Postman web app.
* **Scratch Pad** - The Postman desktop app supports working in Postman offline using [Scratch Pad](/docs/getting-started/using-scratch-pad/).

## Updating Postman

The Postman desktop app notifies you when a major update is available. For other updates, there is a dot on the settings icon <img alt="Settings icon" src="https://assets.postman.com/postman-docs/icon-settings-v9.jpg#icon" width="16px">. If the indicator is red instead of orange, it indicates a failed update.

![Update Ready](https://assets.postman.com/postman-docs/update-ready-v86.jpg)
{'fraction_non_alphanumeric': 0.09528711965225349, 'fraction_numerical': 0.009036833676504232, 'mean_word_length': 4.36020846106683, 'pattern_counts': {'":': 0, '<': 7, '<?xml version=': 0, '>': 45, 'https://': 36, 'lorem ipsum': 0, 'www.': 16, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 50, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '135130', 'n_tokens_mistral': 5186, 'n_tokens_neox': 4901, 'n_words': 2099}