How to change PATH environment variable on Linux

Last updated on July 28, 2020 by Dan Nanni

Question: When I try to run an executable, it complains "command not found." The executable is actually located in /usr/local/bin. How can I add /usr/local/bin to my PATH variable, so that I can run the command without specify the path?

In Linux, PATH environment variable stores a set of directories to search for an executable command when the command is typed by a user. The value of PATH variable is formatted as a series of colon-separated absolute paths. Each user has a user-specific PATH environment variable (initialized with system-wide default PATH variable).

To check the current PATH environment variable of a user, run the following command as the user:

$ echo $PATH

Alternatively, run:

$ env | grep PATH

If the command that you type is not found in any of these directories, the shell will throw an error message: "command not found"

If you want to add an additional directory (e.g., /usr/local/bin) to your PATH variable, you can follow these instructions.

Change PATH Environment Variable for a Particular User Only

If you want to temporarily add a new directory (e.g., /usr/local/bin) to a user's default search path in the current login session, you can simply type the following.

$ PATH=$PATH:/usr/local/bin

Now check if PATH has been updated:

$ echo $PATH

The updated PATH will then remain effective in the current login session. The change, however, will be lost in any new terminal session.

(For bash users) If you want to change PATH variable permanently, open ~/.bashrc (or ~/.bash_profile) with a text editor, and append the following line.

export PATH=$PATH:/usr/local/bin

Then activate the change permanently by running:

$ source ~/.bashrc (or source ~/.bash_profile)

Change PATH Environment Variable System-wide

If you want to permanently add /usr/local/bin to system-wide default PATH variable, edit /etc/profile as follows.

$ sudo vi /etc/profile
export PATH=$PATH:/usr/local/bin

Once you re-login, the updated PATH variable will take effect.

Support Xmodulo

This website is made possible by minimal ads and your gracious donation via PayPal (Credit Card) or Bitcoin (1M161JGAkz3oaHNvTiPFjNYkeABox8rb4g).

Please note that this article is published by under a Creative Commons Attribution-ShareAlike 3.0 Unported License. If you would like to use the whole or any part of this article, you need to cite this web page at as the original source.

Xmodulo © 2021 ‒ AboutWrite for UsFeed ‒ Powered by DigitalOcean