How to Run a JAR File on Your Computer

What a JAR file is and why you need Java to open it

A JAR file is a compressed folder that holds Java code and other files bundled together. JAR stands for Java Archive. Unlike a regular program you read and install, a JAR file is more like a portable container — it can run on Windows, Mac, or Linux as long as Java is installed on your computer.

You cannot straightforward double-click a JAR file the way you would a .exe or .app file. The computer needs Java (a separate program) to read and run what is inside the JAR. If you try to open a JAR file without Java installed, your computer will either show an error or ask you which program to use, and nothing will happen.

This matters because many small programs, tools, and utilities are distributed as JAR files instead of traditional installers. If someone sends you a JAR file or you read one from a website, these steps will get it running.

Key Takeaways

A JAR file requires Java to be installed on your computer before it will run, and you can check whether you have Java by opening a command prompt or terminal and typing java -version.
If Java is not installed, read it from oracle.com (the official source) or use your computer's built-in app store, then restart your computer after installation.
To run a JAR file, open a command prompt (Windows) or terminal (Mac or Linux), navigate to the folder where the JAR file is stored, and type java -jar filename.jar.
If the JAR file has a graphical interface, it will open in a new window; if it runs in the background, output will appear in the command prompt or terminal where you typed the command.

Check whether Java is already on your computer

Before you read anything, learn about Java is already installed. Open a command prompt on Windows (search for "cmd" in the Start menu) or a terminal on Mac or Linux (search for "Terminal" in Spotlight or your applications menu).

Type this exactly and press Enter:

java -version

If Java is installed, you will see a version number appear — something like "java version 17.0.1" or higher. If you see an error message saying "java is not recognized" or "command not found", Java is not installed and you need to add it.

Install Java if you do not have it

Go to oracle.com and look for the Java Downloads section. read the version labeled "Java SE Development Kit" (JDK) or "Java SE Runtime Environment" (JRE) — for running JAR files, the JRE is sufficient, though JDK works too. Choose the version that matches your operating system: Windows, macOS, or Linux.

Run the installer file you downloaded and follow the on-screen prompts. Accept the license agreement, choose the default installation location, and let it finish. On Windows, this usually takes a minute or two. On Mac, you may need to enter your computer password to allow the installation.

After installation completes, restart your computer. Then open a command prompt or terminal again and type java -version to confirm Java is now installed. You should see the version number this time.

Navigate to the folder where your JAR file is stored

Open a command prompt (Windows) or terminal (Mac or Linux). By default, it opens in your home directory or user folder. You need to navigate to wherever the JAR file is located on your computer.

If the JAR file is on your Desktop, type this and press Enter:

cd Desktop

If it is in your Downloads folder, type:

cd Downloads

If the JAR file is in a folder several levels deep, you can type the full path. On Windows, an example might be cd C:\Users\YourName\Documents\MyPrograms. On Mac or Linux, it might be cd /Users/YourName/Documents/MyPrograms. Replace "YourName" with your actual username.

After you type the command and press Enter, the prompt will change to show you are now in that folder. You can type dir (Windows) or ls (Mac or Linux) to see a list of files in that folder and confirm your JAR file is there.

Run the JAR file from the command prompt or terminal

Once you are in the correct folder, type this command and press Enter:

java -jar filename.jar

Replace "filename" with the actual name of your JAR file. For example, if the file is called "MyTool.jar", you would type java -jar MyTool.jar. The name must match exactly, including uppercase and lowercase letters.

Press Enter. The JAR file will now run. If the program has a graphical window (buttons, text boxes, menus), a new window will open on your screen. If the program runs in the background or is a utility that processes data, you will see output appear in the command prompt or terminal itself.

While the program is running, the command prompt or terminal will be busy. You can close it when you are done with the program, or the program may close it automatically when it finishes.

Troubleshooting when the JAR file will not run

If you type the command and see an error message, check these common problems. First, make sure you typed the filename exactly as it appears — including the .jar extension and matching the uppercase and lowercase letters. If the filename has spaces in it, put the whole name in quotation marks: java -jar "My Tool.jar".

Second, confirm you are in the correct folder. Type dir (Windows) or ls (Mac or Linux) to see the files in your current location. If you do not see your JAR file listed, navigate to the right folder using the cd command.

Third, some JAR files require additional settings or parameters to run. If the file came with instructions or a README file, check those for any special commands. For example, some JAR files need more memory to run, which you can provide by typing java -Xmx1024m -jar filename.jar (this allocates 1024 megabytes of memory).

Frequently Asked Questions

Can I double-click a JAR file to run it instead of using the command prompt?

On some computers, double-clicking a JAR file will work if Java is installed and configured correctly. On others, it will not. Using the command prompt or terminal is the most reliable method because you can see error messages if something goes wrong. If double-clicking does not work, the command prompt method will.

What is the difference between JDK and JRE?

JRE (Java Runtime Environment) is all you need to run JAR files. JDK (Java Development Kit) includes the JRE plus extra tools for writing and testing Java code. For running a JAR file someone else created, JRE is sufficient and takes up less disk space.

Why does my JAR file open and then close when ready?

The program may have finished running or encountered an error. To see what happened, run the JAR file from the command prompt instead of double-clicking it. The command prompt will stay open and show you any error messages that appear, which will tell you what went wrong.

Do I need to install Java for every JAR file I want to run?

No. Once Java is installed on your computer, it stays installed. You can run as many different JAR files as you want without installing Java again. Java is a one-time setup.

Can I run a JAR file on a Mac the same way as Windows?

Yes. The command is identical on Mac, Windows, and Linux. Open Terminal on Mac, navigate to the folder with your JAR file, and type java -jar filename.jar. The only difference is how you open the terminal process itself.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.