---
schema_version: "1"
id: 338394ecbe6ae72112a658d47adc5592beb700b3f8d7b1bef67f3de73aacbb68
title: Maven Preferences Reference
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/studio/maven-preferences-reference.md
canonical_url: https://docs.mulesoft.com/studio/maven-preferences-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: c64d02fc5a023e64f2f1615c6e89a7a9bc254aebcb5e97bdc4314b628a32ee8b
description: MuleSoft Documentation Site
latest: true
---
---
product: Studio
---

# Maven Preferences Reference

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Personalize how Anypoint Studio works with Maven by setting Maven preferences. Studio reads the
Maven `settings.xml` file, which defines the configurations Maven uses during its operation and
tailors the build process for all the projects on your system.

With the `settings.xml` file, you can configure:

- Dependency and plugin repositories

- Proxy servers

- Authentication

- Plugins

See [Maven setting references](https://maven.apache.org/settings.html) for additional information.

To configure Maven setting preferences, open Studio preference settings. In the Preferences panel,
go to **Anypoint Studio** > **Maven**.

See [Maven Reference](https://docs.mulesoft.com/studio/maven-preferences-reference) for additional
information about configuring MuleSoft repositories.

![\*Maven Preferences Reference\* window accessed from the \*Settings…​\* option, from the \*Anypoint Studio\* menu](/mulesoft/current/en-us/studio/_images/maven-preferences-reference.png)

<table><colgroup><col> <col> <col></colgroup><thead><tr><th>Preference</th><th>Description</th><th>Default Value</th></tr></thead><tbody><tr><td><p>Display runtime version not available warnings</p></td><td><p>When enabled, it warns you when the runtime version configured in your <code>pom.xml</code> file is different from the one configured in your project.</p></td><td><p>Enabled</p></td></tr><tr><td><p>Use embedded Maven installation</p></td><td><p>When enabled, it uses the Maven installation embedded in Anypoint Studio.</p></td><td><p>Enabled</p></td></tr><tr><td><p>Maven installation home directory</p></td><td><p>The directory of your local Maven installation.<br>You can only edit this preference when you disable <strong>Use embedded Maven installation</strong>.</p></td><td><p>Empty</p></td></tr><tr><td><p>Override settings security path</p></td><td><p>When selected, this option overrides Maven default <code>settings_security.xml</code> path.<br>Selecting this option requires you to define your custom path to your <code>settings_security.xml</code> file in the <strong>Path to settings_security.xml</strong> field.</p></td><td><p>Disabled</p></td></tr><tr><td><p>Override Maven local repository location</p></td><td><p>When selected, this option overrides Maven default local repository location.<br>Selecting this option requires you to define your custom path to your Maven local repository.</p></td><td><p>Disabled</p></td></tr><tr><td><p>MAVEN_OPTS environment variable</p></td><td><p>MAVEN_OPTS contains parameters to start up the JVM or to pass memory options to Maven before it runs.</p></td><td><p>Empty</p></td></tr><tr><td><p>Base command line for builds</p></td><td><p>The Maven command to execute every time you build or run a Mule project in your local machine.</p></td><td><p>mvn clean package -nsu -DskipMunitTests</p></td></tr></tbody></table>

## Configure Global Settings

Studio manages the servers used in the global settings and you can configure Studio to use an
external Maven installation. By doing so, Studio automatically detects and populates the IDs from
the `settings.xml` file stored in `${maven.installation.home}/conf/settings.xml`.

![“\*Global Settings\* option highlighted in the Studio setting preferences window”](/mulesoft/current/en-us/studio/_images/maven-global-settings.png)

If there is no file on this path, you can create a new `settings.xml` file in another location:

1.  Select **Override global settings path**.

2.  Click **Browse**.

3.  Select your `settings.xml` file and click **Open**. + The IDs are listed.

4.  Click **Apply and Close**.

## Configure Update Policies

You can configure Maven update policies depending on your needs.

![“\*Update Policies\* option highlighted in the Studio setting preferences window”](/mulesoft/current/en-us/studio/_images/maven-update-policies.png)

See the `<updatePolicy>` in the
[**Repositories** section](https://maven.apache.org/settings.html#repositories) of Maven Settings
Reference for additional information.

## Configure User Settings

Studio manages the servers for downloading dependencies or plugins, defines the credentials of such
servers when needed, and automatically detects and populates the IDs from the `settings.xml` file
located in `${user.home}/.m2/settings.xml`.

![“\*User Settings\* option highlighted in the Studio setting preferences window”](/mulesoft/current/en-us/studio/_images/maven-user-settings.png)

If there is no file on this path, you can create a new `settings.xml` file in another location:

1.  Select **Override user settings path**.

2.  Click **Browse**.

3.  Select your `settings.xml` file and click **Open**. + The IDs are listed.

4.  Click **Apply and Close**.

### Add a Server

To add a new server to your `settings.xml` file:

1.  In the **User Settings** window, click **Add**.

2.  Enter the server ID, and your username and password.

3.  Click **OK**.

![“\*Add server\* option highlighted in the Studio setting preferences window”](/mulesoft/current/en-us/studio/_images/maven-add-new-server.png)

## See Also

- [Add Modules to Your Project](https://docs.mulesoft.com/studio/add-modules-in-studio-to)