Update: The link below does not have a complete answer. Having to set the path or variable in two places (one for GUI and one for shell) is lame.
Not Duplicate of: Setting environment variables in OS X?
Coming from a Windows background where it's very easy to set and modify environment variables (just go to System Properties > Advanced > Environment Variables), it does not seem to be that straight forward on Mac OS 10.5. Most references say I should update /etc/profile or ~/.profile. Are those the equivalent of System Variables and User Variables? For example, where should I set my JAVA_HOME
variable?
EDIT:
I want to be able to access the variable from the terminal as well as an app like Eclipse. Also, I hope I don't have to restart/logout to make this take effect.
Best Answer
There are several places where you can set environment variables.
~/.profile
: use this for variables you want to set in all programs launched from the terminal (note that, unlike on Linux, all shells opened in Terminal.app are login shells).~/.bashrc
: this is invoked for shells which are not login shells. Use this for aliases and other things which need to be redefined in subshells, not for environment variables that are inherited./etc/profile
: this is loaded before ~/.profile, but is otherwise equivalent. Use it when you want the variable to apply to terminal programs launched by all users on the machine (assuming they use bash).~/.MacOSX/environment.plist
: this is read by loginwindow on login. It applies to all applications, including GUI ones, except those launched by Spotlight in 10.5 (not 10.6). It requires you to logout and login again for changes to take effect. This file is no longer supported as of OS X 10.8.launchd
instance: this applies to all programs launched by the user, GUI and CLI. You can apply changes at any time by using thesetenv
command inlaunchctl
. In theory, you should be able to putsetenv
commands in~/.launchd.conf
, andlaunchd
would read them automatically when the user logs in, but in practice support for this file was never implemented. Instead, you can use another mechanism to execute a script at login, and have that script calllaunchctl
to set up thelaunchd
environment./etc/launchd.conf
: this is read by launchd when the system starts up and when a user logs in. They affect every single process on the system, because launchd is the root process. To apply changes to the running root launchd you can pipe the commands intosudo launchctl
.The fundamental things to understand are:
launchctl
; the updated variables are then inherited by all new processes it forks from then on.Example of setting an environment variable with launchd:
Now, launch your GUI app that uses the variable, and voila!
To work around the fact that
~/.launchd.conf
does not work, you can put the following script in~/Library/LaunchAgents/local.launchd.conf.plist
:Then you can put
setenv REPLACE_WITH_VAR REPLACE_WITH_VALUE
inside~/.launchd.conf
, and it will be executed at each login.Note that, when piping a command list into launchctl in this fashion, you will not be able to set environment variables with values containing spaces. If you need to do so, you can call launchctl as follows:
launchctl setenv MYVARIABLE "QUOTE THE STRING"
.Also, note that other programs that run at login may execute before the launchagent, and thus may not see the environment variables it sets.