How to Install Anypoint Studio (Step-by-Step, All OS) — 2026 Guide

 

How to Install Anypoint Studio (Step-by-Step, All OS)

This is where the "reading about MuleSoft" phase ends and the "actually building things" phase begins. Anypoint Studio is the desktop IDE where you'll spend most of your time as a MuleSoft developer — it's an Eclipse-based tool, so if you've used Eclipse or any similar IDE before, the interface will feel familiar.

This guide walks through installation on Windows, macOS, and Linux, plus the handful of setup gotchas that trip up beginners.

Before You Start: System Requirements

• Operating System: Windows, macOS, or Linux (Studio supports all three)
• Java: Anypoint Studio 7.21 and later builds and runs projects on Java 17 by default. If you're working with newer Mule runtime versions (4.9+), Java 17 is required — older Mule versions (4.4 and earlier) still work with Java 8 or 11
• Disk space: Plan for a few GB free — the download and installed application aren't small
• RAM: 8GB minimum is comfortable; Studio (like most Eclipse-based IDEs) is not lightweight

You don't need to manually install a separate JDK first in most cases — recent Studio versions bundle what they need — but it's worth confirming your Java version afterward if you run into issues (Help/About menu, or java -version in a terminal).

Step 1: Download Anypoint Studio

Go to MuleSoft's official download page and select your operating system. You'll typically need to fill in some basic details (email, country) to access the download link, which arrives in your inbox — this is standard for MuleSoft's site, not a scam trigger, so don't be alarmed by the extra step.

The download is a substantial file (roughly 1–2 GB), so give it time depending on your connection.

Step 2: Install — By Operating System

Windows

1. Extract the downloaded file into your C:\ root folder (not deeply nested — Windows path length limits can cause issues with deeply nested extraction paths)
2. Open the extracted Anypoint Studio executable
3. Windows Security may flag the embedded OpenJDK libraries on first run — allow the OpenJDK Platform library (published by Temurin) through your firewall when prompted
4. Tip: Windows Defender's real-time scanning can noticeably slow Studio down since it scans files as they're accessed. Consider excluding the Studio folder from real-time protection once you've confirmed the install is legitimate and working

macOS

1. Extract the downloaded package and move it into your /Applications directory
2. Open the extracted Anypoint Studio app
3. macOS Gatekeeper will likely flag it as an unverified/unsafe application on first launch — go to System Preferences → Security & Privacy → General and select Open Anyway
4. Click OK to accept the default workspace when prompted

Linux

1. Extract the downloaded archive
2. Open the extracted Anypoint Studio executable
3. Accept the default workspace, or specify a custom one

Step 3: The Workspace

On first launch, Studio asks you to choose a workspace — the folder on disk where your Mule projects and configuration files will live.

Important gotcha for Linux/Mac users: Anypoint Studio does not expand the ~ (tilde) shortcut the way your terminal does. If you try to set your workspace to ~/mule-projects, Studio may not resolve it correctly. Always use the absolute path instead — e.g. /home/yourname/mule-projects rather than ~/mule-projects.

Step 4: Confirm It's Working

Once Studio loads, you should see the welcome screen with a Get Started button. Click through it, and you'll land on the main Studio interface — the Package Explorer on the left, the canvas in the middle where you'll build flows visually, and the Mule Palette on the right listing available connectors and components.

To double-check your installed version and bundled Mule runtime, go to the menu bar: Anypoint Studio → About Anypoint Studio. Anypoint Studio bundles the latest Mule runtime engine version available for each Studio release, so unless you have a specific reason to use an older Mule version, the bundled one is fine to start with.

Common Beginner Issues

Problem	Likely Cause	Fix
Studio won't open on Mac	Gatekeeper blocking it	Security & Privacy → Open Anyway
Windows flags it as unsafe	Unsigned OpenJDK component	Allow through Windows Defender/firewall
Studio feels sluggish	Real-time antivirus scanning	Exclude Studio folder from real-time scans
Workspace path errors	Used ~ instead of full path	Use absolute paths, especially on Linux/Mac
Wrong Java version errors	Studio expects Java 17 for newer Mule versions	Check installed JDK version matches your Mule runtime's requirement

What's Next

With Studio installed, the next step is getting oriented in Anypoint Platform itself — the cloud side of things, separate from the desktop IDE — before you build your first flow.

Next up in this series: Anypoint Platform Walkthrough: A Tour for Beginners