# Setup: Install IntelliJ IDEA

Install IntelliJ IDEA, connect it to your Java 25 JDK, and run a first sample program.

Novice · Operating System · Java · Updated November 16, 2026

By Gregor Dzierzon

## After this lesson you can

- Create and run a Java project in IntelliJ IDEA

**macOS only.** IntelliJ IDEA is the IDE you will use for all your Java work. IntelliJ IDEA is now a single product: its core features, which cover everything in this bootcamp, are free. It used to come in a separate free Community Edition, which no longer exists.

## Install IntelliJ IDEA

```bash
brew install --cask intellij-idea
```

The download is large, so this can take a few minutes.

## Open it the first time

Open **Applications** in Finder and double-click **IntelliJ IDEA**. If macOS asks whether you want to open an app downloaded from the internet, click **Open**.

On the first launch, IntelliJ IDEA asks a few questions:

1. Read and accept the **User Agreement**.
2. Choose whether to share anonymous usage data. Either answer is fine.
3. If it offers a free trial of its paid features or asks you to sign in, you can skip it. You do not need the paid features in this bootcamp.

You should then see the **Welcome to IntelliJ IDEA** window.

## Create and run a sample project

1. Click **New Project**.
2. Select **Java** on the left.
3. Set **Name** to `setup-check`.
4. Set **Build system** to **IntelliJ**.
5. Open the **JDK** list and choose the one that shows **25** (for example, **temurin-25**). IntelliJ finds the JDK you installed by itself.
6. Make sure **Add sample code** is checked.
7. Click **Create**.

IntelliJ opens the project with a file named `Main.java`. Click the green **Run** arrow beside the `main` method (or in the toolbar at the top) and choose **Run**.

A **Run** panel opens at the bottom of the window. You should see the sample program's output, followed by:

```text
Process finished with exit code 0
```

`exit code 0` means the program ran without errors. Your Java setup works in IntelliJ.

## Common problems

| What you see | What to do |
|---|---|
| No JDK with 25 in the **JDK** list | Choose **Add JDK from disk…** and select `/Library/Java/JavaVirtualMachines/temurin-25.jdk`. If that folder does not exist, repeat the Java exercise. |
| `Project JDK is not defined` above the code | Click **Setup SDK** in that bar and choose the Java 25 JDK. |
| The Run arrow is gray | IntelliJ is still indexing (watch the progress bar at the bottom). Wait for it to finish. |

Source: https://www.ask-codey.com/lessons/os-and-terminal-tools-macos-setup-intellij-idea
