Eclipse Won't Open on Mac? How to Fix JDK Problems

Almost every Mac problem with Eclipse and Java comes down to one question: does your Mac have an Apple chip or an Intel processor?

1. Click the Apple menu in the top left corner.
2. Choose "About This Mac".
3. If it says "Chip: Apple M1", "M2", "M3" or newer, you have Apple silicon. If it says "Processor: Intel", you have an Intel Mac.

Alternatively, type uname -m in Terminal. arm64 means Apple silicon, x86_64 means Intel.

Remember the answer. For Eclipse and the JDK, the Apple version is called AArch64 or aarch64, and the Intel version x86_64 or x64.

macOS checks apps that don't come from the App Store. If it can't verify an app, it blocks it from starting and shows a warning.

Here's what to do:

1. Only download Eclipse from the official site, eclipse.org.
2. Drag Eclipse.app into the Applications folder and start it from there, not from the download window.
3. If a warning appears, close it. Then open "System Settings", go to "Privacy & Security" and scroll down to the "Security" section.
4. There you'll see a note about Eclipse with an "Open Anyway" button. Click it and confirm with your password.

Since macOS 15 Sequoia, the old trick of Control-clicking a blocked app and choosing "Open" no longer works. The route through System Settings does.

Don't switch off Gatekeeper completely in Terminal, even if forums recommend it. That makes your Mac less secure for every app, not just for Eclipse.

The download page offers two versions for macOS: AArch64 and x86_64. If you download the Intel version on an Apple silicon Mac, you'll often be asked to install Rosetta when it starts, or Eclipse runs noticeably slowly.

The fix is simple: delete the old Eclipse.app and download the version that matches your chip. Do the same with the JDK. Eclipse and the Java it starts with should have the same architecture. An Intel Eclipse with an aarch64 JDK, or the other way round, is a common cause of crashes on startup.

According to the download page, the Eclipse Installer comes with its own Java runtime, and current Eclipse packages usually do too. If you use a download with this built-in Java, you don't need to install anything else just to start Eclipse.

It's different if you get a message like this one:

Version 1.8.0 of the JVM is not suitable for this product.

Then Eclipse has found a Java that's too old. Here's how to point it to a newer one:

1. Install a current JDK that matches your chip, for example JDK 25 as a .dmg. It goes into /Library/Java/JavaVirtualMachines/.
2. Right-click Eclipse.app in the Applications folder, then choose "Show Package Contents".
3. Open Contents/Eclipse/eclipse.ini with TextEdit.
4. Add two lines before the line -vmargs, with the option and the path each on its own line:

-vm
/Library/Java/JavaVirtualMachines/jdk-25.jdk/Contents/Home/bin/java

1. Save and restart Eclipse.

To see the exact folder name, run /usr/libexec/java_home -V in Terminal.

If Eclipse runs but even the starter project from your assignment is marked red, the Java version often doesn't match what your course expects.

1. Open the settings. On a Mac they aren't under "Window > Preferences" as in the Windows guide, but in the app menu under Eclipse > Settings or Eclipse > Preferences, depending on the version.
2. Under Java > Installed JREs you see which Java versions Eclipse knows. Use "Add…" and "Standard VM" to add your JDK. As the folder, choose /Library/Java/JavaVirtualMachines/jdk-25.jdk/Contents/Home.
3. Under Java > Compiler, set the version your course requires.
4. In the project itself, right-click, choose "Properties" and then "Java Build Path" to check that the right JDK is set.

Which version applies should be in your course's setup instructions. If it isn't there, ask your teaching assistant, in the lab session or on your course forum. Don't go your own way, or your submission might not run when it's graded.

If you then see a message like "javac is not recognized" or "command not found: javac" in Terminal, javac is not recognized: causes and fixes will help.

Setting things up can eat a whole evening. That hurts when your next assignment is due on Friday. But you don't have to wait until Eclipse works to start practising.

In Jario you write Java right in the browser, on your MacBook too. You need no JDK and no Eclipse settings, because the code runs on our server. "Run" starts main, and "Check" runs tests against your code. You see right away whether it's correct and don't have to wait for your work to be graded.

Especially in a first programming course, it pays to practise each topic in small steps before the assignment. Typical topics are arrays, methods and recursion and classes and objects. Jario has tasks for them from "Easy" through "Medium" to "Hard". The AI tutor knows the task, your code and the test result and gives you hints, but deliberately not the finished solution. You write the code yourself.

You then do the actual assignment in Eclipse, as your course requires. How to use AI help for that without running into academic integrity problems is covered in AI and programming assignments. How to keep up with weekly assignments without all-nighters is in Weekly programming assignments without all-nighters.

Here's a small example of what a task on classes can look like:

1public class Main {2    public static void main(String[] args) {3        Account account = new Account(100);4        account.deposit(50);5        System.out.println(account.getBalance());6    }7}8
9class Account {10    private int balance;11
12    Account(int start) {13        balance = start;14    }15
16    void deposit(int amount) {17        balance += amount;18    }19
20    int getBalance() {21        return balance;22    }23}

150

You'd write exactly the same thing in Eclipse. So what you learn in the browser carries straight over.

• First check whether your Mac has an Apple chip or Intel, and download Eclipse and the JDK in the same version.
• If macOS blocks Eclipse, allow it under "Privacy & Security" with "Open Anyway".
• If Eclipse finds a Java that's too old, set a newer one in eclipse.ini with -vm.
• Red projects are often caused by the Java version. Set it to what your course requires.
• You can start practising in the browser today. More in How to pass your first programming course.