Install Postman Using Binary File on Ubuntu

Postman is the standard tool for building and testing APIs — you send a request, inspect the response, and store collections of endpoints for your team. Ubuntu does not ship Postman in its default repositories, so the cleanest install is the official Linux binary tarball. This guide extracts it into /opt, links it into your PATH, creates a desktop launcher, verifies the install, and covers the errors people hit — including the "No such file or directory" that comes from a missing symlink target.

Postman API testing workspace with request builder and response panel

Preparing the System Environment

Open a terminal (Ctrl + Alt + T) and refresh the package list — you will need the tar tool and the ability to use sudo:

sudo apt update

Step-by-Step Installation

Step 1: Download the Linux Binary Package

Download the official Linux x64 tarball from the Postman download page (it is usually named postman-linux-x64-<version>.tar.gz). The download lands in ~/Downloads.

Step 2: Extract into /opt

/opt is the standard location for third-party application binaries. Extract the tarball there with root permissions:

sudo tar -xzf ~/Downloads/postman-linux-x64-*.tar.gz -C /opt/

This creates /opt/Postman/ containing the Postman executable. Verify with:

ls /opt/Postman/Postman

Step 3: Create a Symlink in Your PATH

/opt/Postman is not in your PATH, so typing postman would fail. A symlink in /usr/local/bin (which is always in the PATH) fixes that:

sudo ln -s /opt/Postman/Postman /usr/local/bin/postman

Step 4: Create a Desktop Launcher

So Postman appears in your application menu, create a desktop entry file:

nano ~/.local/share/applications/postman.desktop

Paste this content and save:

[Desktop Entry]
Name=Postman
Comment=API Development Environment
Exec=/opt/Postman/Postman
Icon=/opt/Postman/app/resources/app/assets/icon.png
Terminal=false
Type=Application
Categories=Development;

If your icon path is different, locate it with find /opt/Postman -name "*.png" | head.

Verifying the Installation

postman --version
which postman

which postman should print /usr/local/bin/postman, and the app should open when you run postman (or from your application menu).

Common Problems

Problem 1: postman: command not found

Cause: the symlink was not created, or /usr/local/bin is not in your PATH.

Solution: run sudo ln -s /opt/Postman/Postman /usr/local/bin/postman, then check echo $PATH contains /usr/local/bin.

Problem 2: "No such file or directory" when starting Postman

Cause: the symlink points at a path that does not exist — usually the tarball extracted to a different folder name, or the symlink references the old version path after an update.

Solution: verify the real path with ls /opt/Postman/, then re-create the symlink against the correct path.

Problem 3: "Permission denied" while extracting or running

Cause: extraction without sudo, or the binary lacks execute permissions.

Solution: extract with sudo and fix permissions: sudo chmod +x /opt/Postman/Postman.

Problem 4: Postman icon is missing in the menu

Cause: the Icon path in the desktop entry does not match the real icon file.

Solution: update the Icon= line to an existing path found via find /opt/Postman -name "*.png", then refresh the menu database: update-desktop-database ~/.local/share/applications.

How to Uninstall

sudo rm /usr/local/bin/postman
sudo rm -rf /opt/Postman
rm ~/.local/share/applications/postman.desktop

Best Practices

Conclusion

We downloaded the Postman tarball, extracted it to /opt, linked it into the PATH, created a desktop launcher, and verified the install. The key idea is separation: the application lives in /opt/Postman, and the rest of the system only sees a symlink — so reinstalling or removing it is a single command.

Related Articles

A.M. Rinas

Written by A.M. Rinas

Full-Stack Software Engineer working on web applications, DevOps automation, and databases. More about me on the about page, or say hi through the contact page and LinkedIn.

← Back to all articles