How to set JAVA_HOME and PATH in Linux - Step by Step Guide

.Hello guys, welcome to the world of Java application programming. One of the hardest thing to mater is not any feature but environment-specific details which nobody teaches. To bridge that gap, I am going to cover a couple of very important environment variables like PATH and JAVA_HOME.  The JAVA_HOME environment variable points to the JDK installation directory and used by many Java tools and applications like TomcatMaven, Eclipse, NetBeans or IntelliJIDEA, etc. to figure out Java executables as they need Java for running. Like in the previous article, I explained a Maven issue (invalid target release: 1.7, 1.8)  related to Java version, which occurred even though the correct version of Java installed on the machine, but JAVA_HOME was pointing to an older version.

Unfortunately, When you install Java on Linux or Windows, this environment variable is not set automatically. You need to do it yourself. Java developers like me always set mandatory environment variables like JAVA_HOME, PATH, and CLASSPATH on the login scripts executed by the shell when you log in to Linux like, but you can also set JAVA_HOME into /etc/profile for all users.

I'll show you steps on how to find the location of Java and how to set up the JAVA_HOME in Linux in this article, and these steps should also work with any Linux or Java version like Ubuntu, RedHat, CentOS, SUSE, ArchLinux, Debian, Fedora, etc.

Though I strongly encourage every Java developer to learn Linux, it's a really important skill and serves you for a long time. If you decide to improve your Linux skill this year, I suggest you take a look at the Learn Linux in 5 Days and Level Up Your Career course on Udemy, which is both short and sweet and also explains all important details.

1. Steps to set JAVA_HOME in Linux

1) The first step is to find the location where Java is installed on your Linux machine. To check that open putty and connect to your Linux server and type the following command

$ java
Usage: java [-options] class [args...]
(to execute a class)
or java [-options] -jar jarfile [args...]
(to execute a jar file)

where options include:
-d32 use a 32-bit data model if available
-d64 use a 64-bit data model if available
-server to select the "server" VM

It means Java is installed and added to your PATH, so half of the job is done already. All you need to is find the location of JDK, which you can find either by printing PATH as follows

$ echo $PATH


$ which java

You can see that JDK is installed on "/usr/sun/jdk/v1.6.0_16-64bit".

2) Add the following line of your .bash_profile file if you want to set JAVA_HOME for yourself or /etc/profile if you want to set JAVA_HOME for all user

vim ~/bash_profile
export JAVA_HOME=/usr/sun/jdk/v1.6.0_16-64bit/
export PATH = $JAVA_HOME/bin:$PATH


vim /etc/profile
export JAVA_HOME=/usr/sun/jdk/v1.6.0_16-64bit/
export PATH = $JAVA_HOME/bin:$PATH

That's it you are done. Though don't forget to open another shell window by typing bash, csh, or ksh. The new environment variable will not be added to an existing shell, you need to open a new shell window.

Also, if you use bash shell than adding into ~/.bash_profile make sense, if you use csh  (C shell) then add JAVA_HOME into ~/.csh_profile and similarly for ksh (K shell) add JAVA_HOME into ~/.ksh_profile.

They are hidden files in your home directory in Linux, that's why they had prefix dot (.) in their name. You can use "ls - alrt" command to see them.

Here is a sample /etc/profile file with JAVA_HOME and PATH variable defined for your reference:

How to set JAVA_HOME and PATH in Linux

By the way, if you don't see Java installed on your machine, then download the Linux version of Java from Oracle's website and install it.

Once you are done with installation just find the folder where JDK is installed and follow the steps given above to set JAVA_HOME for your Linux environment.

For applications, JAVA_HOME is generally referred on start script. It's bad practice to refer hardcoded path of Java installation in scripts, you will never find Tomcat, Maven, Eclipse, NetBeans or IntelliJ doing that because then when you update to a new Java version they won't be able to use it until you change their start script.

 Using JAVA_HOME makes it easy to switch to a different or new Java version. See The Complete Java MasterClass course on Udemy to learn more about the core concepts of Java in detail.  It's updated for Java 11 and also not very expensive, I just bouthbought11 a couple of days ago.

Use of JAVA_HOME in Linux

2. Why should you set JAVA_HOME in Linux

Even though many developers know about JAVA_HOME, they don't set in their environment due to various reasons. I strongly recommend you to set JAVA_HOME, PATH, and CLASSPATH for your development environment. Here are some reasons why you set JAVA_HOME in Linux

1) It's easy to upgrade JDK without affecting your application startup and config file, which points to JAVA_HOME. You just need to download a new version and make sure your JAVA_HOME points to the new version of Java. This is the best benefit of using an environment variable or links.

2) The JAVA_HOME variable is short and concise instead of the full path to the JDK installation directory.

3) JAVA_HOME variable helps your program achieve platform independence like if your startup script uses JAVA_HOME, then it can run on Windows and UNIX without any modification; you just need to set JAVA_HOME on the respective operating system.

4) The JAVA_HOME is standard, which means other tools that need Java, like Maven, Eclipse can refer to this variable without having any knowledge of where Java is physically installed on your machine, which is obviously different in different user's machine. JAVA_HOME allows everybody to access Java in a common and standard way.

I also suggest joining Java Fundamentals: The Java Language course on Pluaralsight to learn more about Java fundamentals like this one.

How to set JAVA_HOME in Linux

Btw, you would need a Pluralsight membership to get access to this course, which costs around $29 per month or $299 annually (14% discount).

If you don't have Pluralsight membership, I encourage you to get one because it allows you to access their 5000+ online courses on all the latest topics like front-end and back-end development, machine learning, etc. It also includes interactive quizzes, exercises, and the latest certification material.

It's more like Netflix for Software Developers, and Since learning is an important part of our job, Pluralsight membership is a great way to stay ahead of your competition.

They also provide a 10-day free trial without any commitment, which is a great way to not just access this course for free but also to check the quality of courses before joining Pluralsight.

That's all about how to set the JAVA_HOME environment variable in Linux. I have also touched base on why you should do it, which is probably more important. Many tools like Maven and IDEs like Eclipse and Netbeans uses this variable to locate the JDK binaries installed on this machine, hence it's better to set this up. If you face any problem while setting and using the JAVA_HOME environment variable, feel free to ask. I'll be glad to help you out.

Further Learning
The Complete Java MasterClass
Linux Command Line Interface (CLI) Fundamentals
Learn Linux in 5 Days and Level Up Your Career

Other Java basics tutorials for Programmers
  • The 2020 Java Developer RoadMap (guide)
  • 10 Things Java Developer should learn (goals)
  • What is the difference between PATH and CLASSPATH in Java? (answer)
  • What is the java.librarypath system property in Java? (answer)
  • How to run a Java program from the command line? (guide)
  • How to install JDK 7 on Windows 8? (guide)
  • Explanation of HelloWorld Program in Java? (read here)
  • 10 Tips to become a better Java developer (tips)
  • 10 Free Java Courses for Programmers (courses)
  • 10 Frameworks Java and Web Developer should learn (frameworks)
  • 5 Courses to learn Spring Framework in-depth (courses)
  • Top 5 Courses to learn Microservices in Java (courses)
Thanks for reading this article so far. If you like this tutorial, then please share it with your friends and colleagues. If you have any questions or feedback, then please drop a note.

1 comment:

  1. export JAVA_HOME=/usr/sun/jdk/v1.6.0_16-64bit/
    export PATH = $JAVA_HOME/bin:$PATH
    in second line, shouldn't be space befor & after =


Feel free to comment, ask questions if you have any doubt.