How to Run a JAR File on Your Computer

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

A JAR file is a compressed archive — similar to a ZIP file — that contains Java code and resources bundled together. JAR stands for Java Archive. When someone gives you a JAR file, they're giving you a program written in Java that your computer can execute, but only if you have Java installed.

The reason you need Java is straightforward: JAR files are designed to run on the Java Runtime Environment (JRE), which is software that interprets and executes Java code. Without it, your computer won't know what to do with the file. Think of it like needing a PDF reader to open a PDF — the file format itself doesn't run; it needs the right tool.

Before you try to run a JAR file, check whether Java is already on your computer. Many computers come with Java pre-installed, especially if they've had other Java programs run on them before.

Key Takeaways

You must have Java installed on your computer before you can run any JAR file, and you can check this by opening a terminal or command prompt and typing java -version.
If Java is not installed, download the Java Runtime Environment (JRE) from Oracle's official website — not from a third-party site — and follow the installer.
On Windows, you can run a JAR file by double-clicking it if Java is properly installed, or by opening a command prompt in the file's folder and typing java -jar filename.jar.
On Mac and Linux, open a terminal in the JAR file's location and type java -jar filename.jar — double-clicking usually does not work on these systems.
If a JAR file requires more memory than Java allocates by default, you can increase it by adding -Xmx to your command, such as java -Xmx2G -jar filename.jar for 2 gigabytes.

Check whether Java is already installed

Open a terminal or command prompt on your computer. On Windows, press the Windows key, type "cmd", and press Enter. On Mac, open Spotlight (Command + Space), type "terminal", and press Enter. On Linux, open your terminal application from your system menu.

Type this command and press Enter: java -version

If Java is installed, you'll see a version number — something like "java version 17.0.1" or similar. If you see an error message saying "java is not recognized" or "command not found", Java is not installed and you need to install it before proceeding.

Install Java if you don't have it

Go to Oracle's official Java download page at java.com or oracle.com/java/technologies/downloads. Do not download Java from any other website, as third-party sites sometimes bundle unwanted software.

Download the Java Runtime Environment (JRE) — not the Java Development Kit (JDK), unless you plan to write Java code. The JRE is smaller and contains only what you need to run JAR files. Choose the version for your operating system: Windows, Mac, or Linux.

Run the installer file you downloaded and follow the on-screen steps. On Windows and Mac, this is straightforward — just click through the installer. On Linux, you may need to use your package manager or follow command-line instructions depending on your distribution. Once installation finishes, close the installer and verify Java is working by running java -version again in your terminal.

Run a JAR file on Windows

If Java is installed and working, the simplest method on Windows is to double-click the JAR file. Your computer should recognize it and launch the program. If nothing happens when you double-click, Java may not be properly associated with JAR files, and you'll need to use the command-line method instead.

To use the command line: open File Explorer, navigate to the folder containing your JAR file, then right-click in an empty area of that folder and select "Open Command Prompt Here" (or "Open PowerShell Window Here" on newer Windows versions). Type this command and press Enter: java -jar filename.jar — replacing "filename" with the actual name of your JAR file.

If the program starts but then closes immediately, it may require command-line arguments or configuration files in the same folder. Check any documentation that came with the JAR file for instructions on how to run it.

Run a JAR file on Mac and Linux

Double-clicking a JAR file usually does not work on Mac or Linux, so you'll use the terminal instead. Open your terminal application, then navigate to the folder containing your JAR file. You can type cd followed by the folder path, or drag the folder into the terminal window to paste its path automatically.

Once you're in the correct folder, type: java -jar filename.jar — replacing "filename" with the actual name of your JAR file. Press Enter and the program should start.

If you want to run the JAR file without keeping the terminal window open, you can add an ampersand at the end: java -jar filename.jar & This runs the program in the background and returns control of the terminal to you.

Increase memory if the JAR file runs slowly or crashes

Some JAR files need more memory than Java allocates by default. If a program runs slowly, freezes, or crashes with an "out of memory" error, you can increase the memory limit using the -Xmx flag.

Instead of typing java -jar filename.jar, type: java -Xmx2G -jar filename.jar — the "2G" means 2 gigabytes of memory. You can adjust this number based on how much RAM your computer has and how much you want to allocate. For example, -Xmx4G gives 4 gigabytes, and -Xmx512M gives 512 megabytes.

Start with 2 gigabytes and increase it only if the program still has problems. Using too much memory can slow down your entire computer.

Troubleshoot common problems

If you see "file not found" or a similar error, make sure you typed the filename exactly as it appears — including the .jar extension — and that you're in the correct folder. Use dir on Windows or ls on Mac and Linux to list the files in your current folder and verify the name.

If the program starts but immediately closes, check whether it expects a configuration file or command-line arguments. Look for a README file or documentation in the same folder as the JAR file. Some programs require you to create a settings file or pass specific information when launching.

If you see a "version" error, your version of Java may be too old for the JAR file. Check the documentation to see what Java version is required, then download a newer version from Oracle if needed. You can have multiple versions of Java installed at the same time.

Frequently Asked Questions

Can I run a JAR file without installing Java?

No. JAR files are designed to run on the Java Runtime Environment, and there is no way around this requirement. You must have Java installed and working on your computer.

Is it safe to download Java from websites other than Oracle?

No. Download Java only from oracle.com or java.com. Third-party sites sometimes include unwanted software bundled with Java. If you're unsure whether a download is legitimate, go directly to Oracle's official website.

What's the difference between JRE and JDK?

The JRE (Java Runtime Environment) runs Java programs like JAR files. The JDK (Java Development Kit) includes the JRE plus tools for writing and compiling Java code. For running JAR files, you only need the JRE, which is smaller and faster to download.

Why does my JAR file need so much memory?

Some programs are memory-intensive by design — for example, applications that process large files or run complex calculations. If a JAR file consistently needs more than 4 gigabytes, check the documentation to see if there's a lighter version or if you can optimize how you use it.

Can I run a JAR file on a phone or tablet?

Standard JAR files are designed for computers with Java installed. Phones and tablets do not have Java Runtime Environment, so you cannot run a traditional JAR file on them. Some Java programs have been adapted for mobile, but these are separate apps, not JAR files.

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.