Set Up Your Mac

Written & tested for accuracy by a developer (not AI) · Updated June 2026

Set Up Your Mac for Java

This is a free Mac app that installs and configures Java for you. It is from the author of the Mac Install Guide. It is the fastest path to a working, verified Java setup.

You need Java. Maybe Minecraft will not launch, maybe you're enrolled in a class with "install Java" as a requirement, or maybe an app at work simply will not open without it. Don't get bogged down by looking at terminal commands and unreliable AI instructions. And don't risk messing up your Mac just to get Java installed.

This free app does it for you, the way an expert would do it, in about two minutes. You do not type a single command. It shows you each change before it makes it, installs the right Java and sets JAVA_HOME correctly, and then proves Java actually works, so you are not left guessing. If you would rather understand each step, my Mac Install Guide tutorials provide explanations. If you would rather just have Java working, this app is for you.

Download the app "Set Up Your Mac for Java"

No account is needed. There is no trial, no paid upgrade. Most setups finish in a few minutes. There is no catch; the Java it installs is free, standard, open-source software.

Who this is for

Most people who need Java on a Mac are not software developers. You might be:

  • Running a game or an app that needs Java, such as Minecraft, a trading or charting tool, or a desktop program your workplace gave you.
  • Getting ready for a course, an IT, computer science, or other coding class that lists "install Java" as step one.
  • Using data or science software that runs on Java, such as a research or analysis tool.
  • A developer or student who just wants Java installed and JAVA_HOME set correctly without fiddling with the shell.

If someone told you "you need Java" and you would rather not learn how macOS shell configuration works to get there, this app is for you.

What the app does, step by step

I built this to be an app I can trust, so nothing happens behind your back. The app shows you each step, in detail, before it runs anything.

  1. It checks what you have. It looks for any Java (JDK) you already have, checks your JAVA_HOME setting, and inspects your shell configuration, then explains exactly what is missing in plain language.
  2. It recommends the simplest setup. Based on what it found, it picks the easiest path: for most people that is Adoptium's free, open-source Java, or Homebrew if you already use it.
  3. It installs Java with your permission. When you click Install, macOS shows its standard password prompt (nothing custom). Progress shows as it goes, and you can cancel at any moment.
  4. It sets JAVA_HOME for you. If your shell configuration needs a correction, the app shows you the exact change first, then backs up the file before editing it.
  5. It verifies the setup. It opens a fresh shell, runs java -version, and shows you the output, so you know Java genuinely works, not just downloaded. If something is wrong, it explains what.

Most setups take one to three minutes.

Why use the app instead of a tutorial

You can set Java up by hand, and my Install Java on Mac and Set JAVA_HOME on Mac tutorials cover every step. Reading them is still the best way to understand the why.

But the most common way people end up stuck is a small mistake in shell configuration, the kind that leaves Java "installed" yet not actually working. The app avoids that: it makes the right changes without typos, and then proves java -version works in a fresh terminal, so you finish with Java that works, not just downloaded.

I am the author of the Mac Install Guide and have written macOS tutorials since 2018. I added the Set Up Your Mac apps because I kept seeing that some setups are simply easier with a tool than with a tutorial. The app does exactly what the tutorial describes, far faster, with a verified result.

Is it safe to run?

Short answer: yes, and you can check every part of it. This matters especially if you are not a developer and would rather be sure before running an app that changes anything on your Mac.

  • Signed and notarized by Apple. macOS Gatekeeper launches it without warnings, after the standard "downloaded from the internet" first-launch confirmation.
  • Every change is shown first. Before it acts, the app shows you the Java package it will install, the JAVA_HOME line it will add, and the backup it will make. Nothing is stealthy or tricky.
  • Your password stays with macOS. Anything that needs a password uses Apple's standard authorization dialog, so the system handles it, never the app.
  • It does not remove or change what you have. It never uninstalls a Java you already installed, and it does not change which Java your projects use: version managers such as SDKMAN, Mise, or jEnv keep working as before.
  • It does not linger. No background process, no menu bar app, no launchd service, no auto-launch at login, no auto-update. Quit it and it is gone until you open it again. New versions you download yourself, the same way you downloaded this one.

Your privacy

The app sends anonymous event counts so I can tell whether it is actually helping people, for example "the check step finished" or "the verify step passed." It does not send your name, email address, IP address, or any identifier I could use to contact you, and it does not send your shell config, your files, or a list of what is installed on your Mac. Each launch gets a random session identifier that resets when you quit. Full details are in the Mac Install privacy article.

Download the app "Set Up Your Mac for Java"

System requirements and how to run it

The app runs on macOS 14 or later, on Apple Silicon (M-series) or Intel Macs. It needs about 5 MB of disk space, plus about 150 MB of temporary space during the Java install, and an internet connection for the Adoptium or Homebrew download.

First, check the macOS version. If you are running an older version, update macOS to the latest macOS version. Then:

  1. Download Set-Up-Your-Mac-for-Java.dmg from downloads.install.guide.
  2. Double-click the file to mount the disk image.
  3. Drag the app to /Applications/.
  4. Launch the app from /Applications/ or from Spotlight.
  5. Accept the first-run consent screen.
  6. Click "Check Java" to begin.

The app takes care of the rest. I hope you like it.