Gitflow Setup for Anypoint Studio

This article will cover the steps to install Anypoint Studio on your MacOS computer and configure the Gitflow plugin to work natively with Anypoint Studio from start-to-finish.

Initial Installation

This section will cover the basic installation of Anypoint Studio to your machine.

1. Navigate to this link: https://www.mulesoft.com/lp/dl/anypoint-mule-studio

2. Enter your information, similar to the screenshot below. Then click Download

3. Check your email for the download link. Click Go to download page

4. Click Download .dmg

5. Go to your Downloads folder in Finder and double-click the dmg file to start.

6. Move Anypoint Studio’s icon to your Applications folder.

7. Go to your Applications folder and double-click Anypoint Studio to open the app. If prompted, click Open.

8. When the ‘Select a directory as workspace’ pop-up appears, you can leave it default and click Launch

Anypoint Studio is now installed. You may continue to the next page for additional configuration steps.

Installing Maven & Java 17 (optional)

Before continuing, ensure you have Java 17 and Maven installed on your machine. If you do not, just follow the steps below.

1. Open a Terminal window.

2. If needed, install Homebrew with this command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 

If prompted, press return to continue the installation of Homebrew

3. After the command completes, add Homebrew to your PATH by running the following commands sequentially, replacing <your_user> with your Mac username:

echo >> /Users/<your_user>/.zprofile 

echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> /Users/<your_user>/.zprofile 

eval "$(/opt/homebrew/bin/brew shellenv zsh)" 

4. Now, run this command to install Maven:

brew install maven

5. Finally, run this command to install Java 17:

brew install openjdk@17

Set Default JRE and Maven in Anypoint Studio (optional)

Now that Java 17 and Maven are installed, we need to configure Anypoint Studio to point to these installations.

1. In Anypoint Studio, click Anypoint Studio in the Apple toolbar and then click Settings

2. Type JRE in the Quick find box. Then select Installed JREs and click on Add…

3. For JRE Type select MacOS X VM and then click Next >

4. Navigate to your Java 17 installation path and then go to /Contents/Home and use that as your JRE home directory.

NOTE: If you installed OpenJDK using homebrew in the prerequisites earlier in this guide and are having trouble finding your installation, use the sub-steps below:

a.) Press command+G

b.) Enter /opt/homebrew/Cellar/openjdk@17/

c.) Go to your versioned folder then libexec/openjdk.jdk/Contents/Home

d.) Click Open

For example:

/opt/homebrew/Cellar/openjdk@17/17.0.18/libexec/openjdk.jdk/Contents/Home

5. Once you enter the JRE home value, set JRE name to OpenJDK 17 and click Finish

6. Click the checkbox next to OpenJDK 17 and then click Apply

7. In the Quick Find box, remove any existing text and type Maven. Then, select Maven, uncheck the Use embedded Maven installation (Maven 3.9.6) checkbox and click Browse next to Maven installation home directory

8. Select your Maven home path and click Open

NOTE: If you installed Maven using homebrew in the prerequisites earlier in this guide and are having trouble finding your installation, use the sub-steps below:

a.) Open a Terminal window

b.) Run the below command:

mvn -version

c.) Your Maven home directory will be shown in the output.

For example:

pxxxx@ljxxx5xxxj ~ % mvn -version

Apache Maven 3.9.14 (996c630dbxxx6c7621xxx58821xxx58bexxx87xx)

Maven home: /opt/homebrew/Cellar/maven/3.9.14/libexec

9. Once you set the Maven installation home directory, click Apply and Close.

You have now installed Java 17 & Maven on your Mac and have configured Anypoint Studio to use your newly installed setup. You may continue to the next page for steps to configure Git integration with Anypoint Studio.

Anypoint Studio Gitflow Installation

Now, we can install an additional plugin for Anypoint Studio to make managing feature, hotfix, and release branches much easier.

1. In Anypoint Studio, click Anypoint Studio in the Apple toolbar and then click About Anypoint Studio

2. Click Installation Details

3. Next to Git integration for Eclipse, take note of the Version and then click Close

Example Version: 7.3.0.202506031305-r

4. Now, click Help in the Apple toolbar and then select Install New Software…

5. Next to Work with: click the Add… button

6. Enter the following values:

Name: eGit

Location: https://download.eclipse.org/staging/2025-06

Then click Add

7. Now, in the Work with: dropdown, select the newly added eGit option and select Git integration for Eclipse — Gitflow support and then click Next >

NOTE: Make sure it is the same version from (3) above.

8. Click Next > again.

9. Check I accept the terms of the license agreement then click Finish

10. In the pop-up that appears, click Select All then Trust Selected

11. If another pop-up appears, click Select All then Trust Selected

12. When prompted, click Restart Now

Clone a Mule Project from GitHub

Now that we have everything set up, we can pull in a MuleSoft project from GitHub.

NOTE: This section assumes you already have an SSH key configured in GitHub. If you need steps for that, please check GitHub’s guide here: https://docs.github.com/en/free-pro-team@latest/authentication/connecting-to-github-with-ssh

1. Start by navigating to the GitHub repository you wish to clone.

2. Once there, click <>Code select SSH then click the icon in the image below to copy the SSH clone value.

3. Now, open Anypoint Studio and click File>Import…

4. Select Projects from Git (with smart import) and click Next >

5. Then select Clone URI and click Next >

6. In the URI section, paste the value you copied from step (2), ensure Protocol is set to ssh, then enter your passphrase from when you created the key earlier on in the Password section.

The rest of the fields should automatically be filled out when you pasted the value from step (2) into the URI section.

NOTE: To avoid having to enter the passphrase every time, you can optionally select the Store in Secure Store checkbox.

Then click Next >

7. If this is your first time cloning a project, you may see a pop-up appear, prompting you about the authenticity of github.com. Just check the box and click OK.

8. Again, if it is your first time cloning a project, you may see another pop-up stating a known_hosts file does not exist. If this shows up for you, feel free to check the box to create the file and click OK

9. Now, select which branches you would like to clone (default is to clone all branches), and click Next >

10. Ensure the project is being saved to the proper directory (usually it is correct by default and should save to some git folder on your machine), select which branch’s code you would like to open by default, and click Next >

11. In the final window, leave everything as-is and click Finish. The Mule application should now open automatically in Anypoint Studio.