What a JNLP file is and why you have one

A JNLP file is a text file that tells your computer how to download and run a Java application from the internet. JNLP stands for Java Network Launch Protocol. When you click a link to launch a Java program from a website — often something like a banking portal, medical records system, or specialized work software — your browser downloads a .jnlp file instead of running the program directly.

The file itself is small and just contains instructions. Your computer reads it, downloads the actual Java application, and runs it. This approach lets software companies update their programs without asking you to manually download new versions each time.

You'll know you have a JNLP file if you see it in your Downloads folder with a name ending in .jnlp, or if a website offers you a "Launch" or "Open" button that downloads something instead of opening immediately in your browser.

Key Takeaways

  • Your computer needs Java installed to open JNLP files; if you don't have it, download it from java.com first.
  • On Windows, right-click the JNLP file, choose "Open with", and select Java or your default Java launcher.
  • On Mac, double-click the JNLP file or right-click and select "Open"; your system will use Java Web Start automatically if Java is installed.
  • If nothing happens when you try to open the file, check that Java is installed and that your system recognizes .jnlp files as Java files.
  • Some organizations require you to launch JNLP files from their website rather than opening downloaded files directly, for security reasons.

Check whether Java is installed on your computer

Before you can open a JNLP file, your computer must have Java installed. Many computers come with Java pre-installed, but not all, and older versions may no longer work.

To check: open a web browser and go to java.com/en/download/installed.jsp. This page will test whether Java is installed and what version you have. If the page says Java is not detected, or if you see a version older than Java 8, you need to install or update it.

If Java is not installed, go to java.com, click the large "Download" button, and follow the installer for your operating system. The download is free. Once installation finishes, restart your computer before trying to open the JNLP file.

Opening a JNLP file on Windows

Once Java is installed, locate your JNLP file in your Downloads folder or wherever your browser saved it. The file icon usually shows a coffee cup or a generic document.

Right-click the JNLP file. A menu will appear. Look for an option that says "Open with" or "Open with..." — the exact wording depends on your Windows version. Click that option.

A list of programs will appear. Look for Java Web Start, Java(TM) Platform SE Binary, or simply Java. Click it, then click "OK" or "Open". The Java application will download and launch. This may take a few seconds the first time.

If you don't see a Java option in the list, click "Choose another app" or "Browse", navigate to C:\Program Files\Java (or C:\Program Files (x86)\Java on some systems), open the Java folder, then the bin subfolder, and select javaws.exe.

Opening a JNLP file on Mac

Locate your JNLP file in the Downloads folder. Double-click it. If Java is installed, the file will open automatically using Java Web Start, and the application will launch.

If nothing happens when you double-click, right-click the file and select "Open". A dialog may appear asking which program to use. Select Java Web Start from the list. If you don't see it, click "Other", navigate to /Library/Java/JavaVirtualMachines, find your Java version folder, and look for the Java Web Start executable inside it.

On newer Macs with Apple Silicon (M1, M2, M3 chips), make sure you have installed the Apple Silicon version of Java, not the Intel version. You can check this by opening System Preferences, clicking "Java" if it appears, or by going to java.com and downloading the correct version for your chip.

What to do if the file won't open

If you double-click or right-click the JNLP file and nothing happens, the most common cause is that your system doesn't recognize .jnlp files as Java files. This usually means Java is not properly installed or your system's file associations are broken.

First, verify Java is installed by visiting java.com/en/download/installed.jsp again. If it still says Java is not detected, reinstall Java and restart your computer.

If Java is installed but the file still won't open, try opening the JNLP file from the command line. On Windows, open Command Prompt, type javaws C:\Users\YourUsername\Downloads\filename.jnlp (replace YourUsername and filename with your actual paths), and press Enter. On Mac, open Terminal, type javaws ~/Downloads/filename.jnlp, and press Enter. This will tell you if Java can read the file and what error, if any, occurs.

Opening JNLP files directly from a website

Many organizations that use JNLP files ask you to launch them from their website rather than downloading and opening them manually. This is usually for security reasons — the organization can verify your login and ensure you're using the correct version of the application.

When you click a "Launch" button on such a website, your browser will download the JNLP file and may automatically open it with Java Web Start. You may see a security prompt asking whether you trust the application. Read the prompt carefully — it will show the publisher's name and the application's permissions. If you recognize the organization, click "Run" or "Yes" to proceed.

If the application fails to launch from the website, try downloading the JNLP file manually (usually by right-clicking the Launch button and selecting "Save link as"), then opening it using the steps above. If that still doesn't work, contact the organization's support team — they may need to troubleshoot your Java setup or provide an alternative way to access the application.

Security considerations when opening JNLP files

JNLP files can download and run code on your computer, so it's worth understanding the basic security picture. Java Web Start includes a sandbox — a restricted environment that limits what downloaded applications can do. However, some applications request permission to access your files, camera, or other resources, and you'll see a prompt asking whether to allow it.

Only open JNLP files from sources you trust. If you receive a JNLP file via email from an unknown sender, or if a website you don't recognize asks you to launch a JNLP application, treat it with caution. Legitimate JNLP applications usually come from established organizations like banks, government agencies, or employers.

Keep Java updated. Older versions of Java have known security flaws. Java will usually notify you when updates are available, or you can check manually at java.com. Updating Java is free and takes a few minutes.

Frequently Asked Questions

Do I need to install anything besides Java to open a JNLP file?

No. Java Web Start, which handles JNLP files, comes built into Java. Once Java is installed, your computer can open JNLP files. Some applications may require additional software or plugins, but the JNLP file itself will tell you if something is missing when you try to launch it.

Why does my JNLP file open in a text editor instead of launching the application?

Your system is treating the JNLP file as a plain text document instead of recognizing it as a Java file. This means either Java is not installed, or your file associations are broken. Reinstall Java, restart your computer, and try again. If it still opens in a text editor, right-click the file, choose "Open with", and manually select Java Web Start or javaws.exe.

Can I delete the JNLP file after the application launches?

Yes. Once Java Web Start downloads and caches the application, you can delete the JNLP file. The application will continue to work. However, if you need to launch the application again later, you may need the JNLP file or the original website link. Some organizations let you launch the application multiple times from their website without downloading the JNLP file again.

What if the organization that created the application no longer exists or the website is down?

Java Web Start caches applications locally, so if you've launched the application before, it may still run even if the website is down. However, if the cache is cleared or if you're launching for the first time, you won't be able to access it. There's no way to recover a JNLP application if its source is permanently unavailable.

Is it safe to open JNLP files from the internet?

JNLP files from established organizations — banks, government agencies, employers — are generally safe if Java is up to date. Java Web Start includes security protections. However, JNLP files from unknown sources carry risk, just like any downloaded executable. Only open JNLP files from sources you recognize and trust.