Postman installation overview

This page is for Postman Docs, version Latest (v12) (default). For other versions, use one of these documentation indexes: - Latest (v12) (default): https://learning.postman.com/latest-v-12/llms.txt - v11: https://learning.postman.com/v11/llms.txt

Postman provides several installation options and enables you to customize your user experience. With a free Postman account, you can securely access your APIs from different machines and collaborate with others on API design. To scale up your API lifecycle, take advantage of paid Postman plans. You can also set up a proxy server as another security barrier.

To learn how to sign up, sign in, and manage your Postman account settings, see About Postman accounts.

Install Postman

You can install the Postman app on Windows, macOS, and Linux, or use the Postman web app in your browser.

The Postman CLI (postman) brings Postman to your terminal, scripts, and CI/CD pipelines. It’s also how coding agents work with Postman: agents run Postman CLI commands from their shell to build, test, and manage APIs. The Postman CLI is installed with the Postman desktop app, or you can install the Postman CLI on its own. To learn more, see Use the Postman CLI with AI agents and CI/CD.

The Postman plugin for coding agents gives Claude Code, Codex, Cursor, and other coding agents Postman’s skills. With the plugin installed, your agent can build, test, and manage APIs with the Postman CLI without you leaving your coding environment.

If you use the Postman web app, install the Postman Desktop Agent for the best experience. The Desktop Agent routes the web app’s requests through your local machine and network, which avoids the browser’s CORS limitations.

The Postman Visual Studio Code extension enables you to test and collaborate on your APIs directly in the application you use to develop them.

Update Postman

To keep Postman up to date, see Update Postman. To keep the Desktop Agent up to date, see Update the Postman Desktop Agent.

Use Postman behind a firewall

If your organization operates behind a network firewall, your IT team may need to allowlist certain domains for Postman to connect to its services. For the full list of domains to allowlist, see Firewall configuration.

Troubleshoot your Postman installation

If you encounter issues installing or running Postman, see Troubleshoot your Postman installation.

System requirements

For a list of Postman’s system requirements, see Postman system requirements.

Manage your Postman settings

Postman enables you to customize your user experience by adjusting your Postman theme, shortcuts, add-ons, and other options in the Postman Settings. To learn more, see Customize Postman settings.

Manage your Postman profile

A Postman profile helps you organize your work and enables you to share your public APIs, collections, and workspaces with other Postman users. For more information, see Customize your Postman profile.

Configure a proxy server

A proxy server prevents others from accessing your internal network. By default, the Postman desktop app uses your system’s configured proxy to send API requests or access the internet. But you can also configure Postman to use the system proxy or a custom proxy when sending requests. To learn more, see Configure Postman to use a proxy server.