- setting environment variables
are very common here, and in most cases the answers are very similar to each other. In the future it would be nice to have a good Q/A for this.
So the question is: What are environment variables, like the executable
PATH, and how can I change and use them on major operating systems?
A good answer would include a simple explanation of what environment variables and especially
PATHmean to the OS, as well as simple guidelines on how to set and read them accordingly.
What are Environment Variables?
Environment variables hold values related to the current environment, like the Operating System or user sessions.
One of the most well-known is called
PATH on Windows, Linux and Mac OS X. It specifies the directories in which executable programs* are located on the machine that can be started without knowing and typing the whole path to the file on the command line. (Or in Windows, the Run dialog in the Start Menu or +R).
On Linux and Mac OS X, it usually holds all
sbin directories relevant for the current user. On Windows, it contains at least the
C:\Windows\system32 directories — that’s why you can run
notepad.exe from the command line or Run dialog, but not
firefox.exe. (Firefox is located in
C:\Program Files\Mozilla Firefox. For information on how to include Firefox, go here.)
For example, typing
.exe can be omitted) in the command line on Windows will start up the Windows Calculator.
* You can add support for file extensions other than
.exe by editing
Other variables might tell programs what kind of terminal is used (
TERM on Linux/Mac OS X), or, on Windows, where the Windows folder is located (e.g.,
Creating new environment variables
In Windows, Linux and Unix, it’s possible to create new environment variables, whose values are then made available to all programs upon launch.
You can use this when writing scripts or programs that are installed or deployed to multiple machines and need to reference values that are specific to these machines. While a similar effect can be achieved using program-specific configuration settings, it’s easier to do this using an environment variable if multiple programs need to access the same value.
Control Panel » System » Advanced » Environment Variables.
control sysdm.cpl,,3in the Run dialog (+R) and click
For editing user variables you can also type
in the Run dialog.
Right-click (My) Computer and click on Properties, or simply press +Break.
- In XP click on
Advanced » Environment Variables.
- In Vista+ click on
Advanced system settings » Environment Variables.
- In XP click on
There are many other ways of reaching the same place, such as by typing “environment variables” in the Start Menu/Screen search box and so on.
Environment variables in Windows are separated into user and machine/system specific values. You can view and edit their values there. Their current values upon launch are made available to all programs.
There is also Rapid Environment Editor, which helps setting and changing environment variables in Windows without the need to go deep into the system settings. Another open source program for Windows with which the path environment can be edited very conveniently is Path Editor.
Environment Variables in Windows are denoted with percent signs (%) surrounding the name:
To display an environment variable’s value in
C:\>echo %USERPROFILE% C:\Users\Daniel
To create/set a variable, use
C:\>set FunnyCatPictures=C:\Users\Daniel\Pictures\Funny Cat Pictures C:\>set FunnyCatPicturesTwo=%USERPROFILE%\Pictures\Funny Cat Pictures 2
To append/add a variable, use
C:\>set Penguins=C:\Linux C:\>set Penguins=C:\Windows;%Penguins% C:\>echo %Penguins% C:\Windows;C:\Linux
Environment variables set in this way are available for (the rest of)
the duration of the Command Prompt process in which they are set,
and are available to processes that are started after the variables were set.
To create/set a variable permanently, use
setx varname "value":
C:\>setx FunnyCatPictures "C:\Users\Daniel\Pictures\Funny Cat Pictures" [Restart CMD] C:\>echo %FunnyCatPictures% C:\Users\Daniel\Pictures\Funny Cat Pictures
set, there is no equals sign and the value should be enclosed in quotes if it contains any spaces. Note that variables may expand to a string with spaces (e.g.,
C:\Program Files), so it is best to include quotes around values that contain any variables.
You must manually add
setx to versions of Windows earlier than Vista.
Windows XP Service Pack 2 Support Tools
List of Windows Environment Variables
Here is a list of default environment variables, which are built into Windows. Some examples are:
Like most names in Windows, these are case-insensitive.
Unix derivatives (FreeBSD, GNU / Linux, OS X)
Environment Variables in Linux are prefixed with a dollar sign ($) such as $HOME or $HOSTNAME. Many well-known and standard variables are spelled out in capital letters to signify just that. Keep in mind that variable names are case-sensitive, meaning that $User and $USER are entirely unrelated from the shell’s point of view.
Unix derivatives define system wide variables in shell scripts located mostly in the
/etc folder, but user-specific values may be given to those variables in scripts located in the home folder (e.g.,
.profile file in the home folder is a common place to define user variables.
These files are regular shell scripts and can contain more than just environment variable declarations. To set an environment variable, use
export. To show your currently defined environment variables in a terminal, run
export command is a standard way to define variables. The syntax is very intuitive. The outcome is identical for these two lines, but the first alternative is preferable in case portability to pre-POSIX Bourne shell is necessary.
var=value; export var export var=value
The C shell and its descendants use a completely different syntax; there, the command is
See the Linux documentation project, Path HOWTO for a more thorough discussion on this topic.
Perhaps contrary to common belief, OS X is more “Unix” than Linux. Additionally to the files already mentioned, $PATH can be modified in these files:
/etc/pathscontains all default directories that are added to the path, like
- Any file in
/etc/paths.d— commonly used by installers to make the executable files they provide available from the shell without touching system-wide or user-specific configuration files. These files simply contain one path per line. e.g., /Programs/Mozilla/Calendar/bin.