I want to add a directory to search my search path. I know I have to modify the PATH environment variable. However, I want the change to be permanent, so that it is always in effect, for every Terminal (bash) window I open.

There is an overload of confusing and possibly conflicting information in https://help.ubuntu.com/community/EnvironmentVariables

I am using Ubuntu 10.04. Suppose I want to add /usr/local/foo to my PATH. Which file (.bashrc, .profile, .bash_login, etc...) should I modify and what should the new line(s) look like?

up vote 62 down vote accepted

The following command adds a path to your current path:

export PATH=$PATH:/my/custom/path

If you want your setup to execute this command every time, there are a number of places where you can put it. When you login, the following scripts will be executed in this order:

/etc/profile      (which starts by loading everything in /etc/profile.d)
~/.profile        (which starts by loading ~/.bashrc if you are running bash)

Notes

  • ~/.profile is only loaded if ~/.bash_profile and ~/.bash_login DO NOT EXIST. Otherwise, at least bash, will load them instead. It is advisable to use .profile and not the bash specific scripts. So, if in these attempts you created .bash_login, please delete it now.

  • ~/.bashrc is only loaded if you are running an interactive session. (something with a prompt where you can actually type something).

  • ~/.bashrc is loaded again and again, every time you open up a new terminal. So a new tab in gnome-terminal, a new virtual terminal, etc. So even if you don't login again, .bashrc is loaded (and thereby resets its environment) every time you open a new shell.

  • Things like byobu should really go into .profile, (otherwise it won't work ;-)

  • Things like paths should go into .profile if you want them to work outside of the interactive sessions. (say when you press Alt+F2 in GNOME)

  • I'll mark this as the answer if you update it to include the requested export line that should be added to .profile. – Joshua Flanagan Sep 8 '10 at 0:13
  • This used to be valid only for console logins (e.g. ssh, or the virtual terminals accessible for Ctrl+Alt+Fx). I didn't know that /etc/gdm/Xsession sources ~/.profile these days. Neat! – Marius Gedminas Sep 9 '10 at 14:31
  • Yeah, i didn't mention /etc/gdm/Xsession specifically or ~/.Xprofile because there are better ways to make graphical programs launch at start up, which does garantuee that the rest of the environment is already loaded. – Ralf Sep 10 '10 at 15:14
  • 1
    to make this answer more comprehensive please add MattH's comment about sourcing ~/.profile to activate changes without a logoff/on cycle. – matt wilkie Nov 17 '10 at 21:36
  • 1
    @schwiz: ~/.profile is not executed on each terminal, it is executed before, when your desktop session starts. The one executed on every terminal is ~/.bashrc – MestreLion Apr 11 '13 at 8:28

I got it to work by modifying ~/.profile

It looks like adding ~/bin to my path was a bad example, as there is already code in ~/.profile to do that automatically, if the directory exists.

To add the usr/local/foo directory to my path for every session going forward, I add/edit the following line at the end of my .profile:

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

However, to make this take effect, I needed to log out and log back in (simply closing the Terminal window and opening a new one did NOT work).

  • 4
    Make that export PATH="$PATH:/usr/foo", in case you ever have spaces or other special characters in $PATH. – Gilles Sep 6 '10 at 19:52
  • 3
    You can reload the current environment without logging out by typing ". ~/.profile" – Matt H Sep 7 '10 at 2:30
  • 1
    @MattH: no you can't. if you source ~/.profile in a given terminal, it will be effective for that terminal only – MestreLion Apr 11 '13 at 8:32
  • @MestreLion - you are right. I was mentioning it for convenience for the current terminal. Forgot to add that. – Matt H Apr 18 '13 at 1:18
  • What if I already have something in PATH? Could I append to it like PATHS work in Windows? For example I have PATH="$HOME/bin:$HOME/.local/bin:$PATH" already. – Gabriel Fair Oct 27 '17 at 22:29

To reload .profile and take changes effects without logout/login, run:

source ~/.profile

You can add the path to /etc/environment, but be aware that no shell expansions will work; the variable will be set to literally the characters you enter.

  • Out of the two methods(adding export command in .profile and adding full path name to PATH in etc/environment), which should be preferred? – Rohan Bhatia Jan 3 at 13:14

Youcan modify the .bashrc file in your $HOME directory.

At the very end of this file, add the line:

export PATH="$HOME/directory_to_include_in_path/:$PATH"

You can also modify the .profile file, also in your $HOME directory, including the following line:

PATH="$HOME/directory_to_include_in_path/:$PATH"

This worked for me.

  • 2
    I don't see what this adds to the other answers which explain more thoroughly. – Zanna Jun 3 '17 at 15:47
Going through the basics, I will suggest the following steps:
1. It's recommended to set environment variables in /etc/environment
2. Open the file as superuser in an editor as it's a read only file e.g.     gedit:
gksu gedit /etc/environment
3. System will need password to open it in editable mode. Enter your superuser password and get file opened in a new gedit window. 
4. Add new line at the end of file with 
export PATH=$PATH:/usr/local/foo
5. Save and close the window. It will get command back to terminal.
6. Refresh the environment by running the following command: 
. /etc/environment
7. You may check by executing the following command:
 echo $PATH
  • This is incorrect and will not work. Parameter expansion is not performed in /etc/environment – Zanna Jun 3 '17 at 15:16

Your Answer

By clicking "Post Your Answer", you acknowledge that you have read our updated terms of service, privacy policy and cookie policy, and that your continued use of the website is subject to these policies.

Not the answer you're looking for? Browse other questions tagged or ask your own question.