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.
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
- Install to
/optand symlink — this keeps updates to a simple re-extract and symlink refresh. - Do not run Postman with
sudo; it creates config files in your home directory and running as root causes permission headaches later. - Check
~/.config/Postmanfor configuration backups before uninstalling. - Prefer the binary method when your distribution does not provide a snap/flatpak you trust, since the tarball runs without containerization overhead.
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.