Configuring the PATH System Variable

Favorited Favorite 1


A path is the name of a file's directory, which specifies a unique location in a file system. Whereas, the PATH system variable ($PATH), specifies a set of directories where executable programs are located. This allows software applications to access commonly executed programs.

There are different methods for modifying the ($)PATH variable on various operating systems. The directions below are based on the most common methods for each operating system. For more information, just use your favorite search engine with the keywords: path system variable along with <the name of the OS you are working on>.

Windows 10

In Windows 10, the PATH system variable is configured through the System Properties window. There are various methods for users to access the System Properties window; for example, users can search view advanced system settings from the taskbar ⊞ Start menu.

searching for system properties window
Searching view adva from the taskbar ⊞ Start menu, to access the the System Properties window. (Click to enlarge)

Once the System Properties window has been pulled up, select the Environment Variables... button from the Advanced tab.

opening the environment variables window
Opening the Environment Variables window. (Click to enlarge)

Within the Environment Variables window, select the Path variable from the User variables for <username> section. Then, select the Edit... button to configure the PATH system variable.

Note: The User variables are specific for a user account on the computer; while, the System variables will be available for all accounts on the computer.

opening the path system variable window
Opening the PATH system variable window. (Click to enlarge)

From the PATH Edit environment variable window, select the Browse... button. Once the pop-up dialog box appears, navigate to the folder containing the executable file to be included in the PATH system variable.

Note: Make sure not to select and overwrite a previously configured file path. Users can click on the black space area to make sure that a previously configured file path isn't highlighted and therefore, won't get overwritten.

adding a directory to the path system variable
Adding a directory to the PATH system variable. (Click to enlarge)

Mac OSX and Linux Based Systems

On Mac OSX and linux based systems, users can display the paths for the $PATH system variable by entering echo $PATH into the terminal.

Note: The commands below use the GNU nano text editor. Feel free to use another text editor of your choice (such as vi for Vim).

To modify the variable:

  1. Open up Terminal and run the following command to edit the paths file: sudo nano <file path location>
    • There are several locations where users might be able to modify the $PATH system variable:
      • /etc/paths (Mac OSX - Mountain Lion)
      • /usr/bin
      • /usr/local/bin
      • /usr/local/sbin
      • /usr/sbin
      • ~/.bash_profile
      • ~/.bashrc
      • ~/.profile
  2. Enter the super user (administrative) password, if prompted.
  3. Enter the modifications for the path you wish to add.
    • The entry field is usually near the bottom of the file.
  4. Hit Ctrl+X to quit.
  5. At the input prompt, send Y and hit Enter or Return to save the modified buffer.

PATH variable
Displaying paths of $PATH variable and accessing the ~/.profile file for modifications. (Click to enlarge)

That’s it! To verify the changes, in a terminal window, type: echo $PATH

Note: Another common method is to use the export command in the terminal.

Example: export PATH=$PATH:<file path to be added>

Resources and Going Further

Looking for some additional programming related tutorials? Check out the guides below:

Binary Blaster Assembly Guide

Learn how to assemble and play the Binary Blaster Game from SparkFun Electronics.

Experiment Guide for the Johnny-Five Inventor's Kit

Use the Tessel 2 and the Johnny Five Inventors kit to explore the world of JavaScript enabled hardware through 14 awesome experiments!

Simon Says Experiments

So you've built up a Simon Says kit? What next? This tutorial will get you up and running with Arduino software, guide you through a few example sketches, and send you on your way to create your own. Careful, this stuff is highly addictive. :)

Programming the SparkFun Edge with Arduino

Running low-power machine learning examples on the SparkFun Edge can now be done using the familiar Arduino IDE. In this follow-up to the initial Edge tutorial, we'll look at how to get three examples up and running without the need to learn an entirely new SDK.