top of page

How to add JVM/Command-line arguments to the Mule 4 Runtime in Anypoint Code Builder (ACB)


In this post:


I've received this question a lot lately, so I figured I'd create a quick post about it.

Adding JVM or Command-line arguments to your Mule Runtime is especially useful when you're using properties files that are separated by environment. It is also useful to pass a secure/encryption key to your Mule application when you have secured properties. Let's learn how to pass these arguments in ACB.


  • Visual Studio Code - To use Anypoint Code Builder (Desktop), you must first install VS Code. You can download it here.

  • Anypoint Extension Pack - To enable Anypoint Code Builder in your Visual Studio Code, you must install this extension. You can install it from here.

  • REST Client - A lot of people use Postman. You can also use curl if you're more into the command line, or Thunder Client for VS Code. We'll use Thunder Client for this post.

  • GitHub Repo - If you want to follow along with the code I generated, you can check it out here.

Create the Mule project

You can use the GitHub repository listed in the prerequisites, or you can generate your code by following the next instructions.

In ACB, click on Develop an Integration and give a name to the project. In our case, it will be test-project. Click on Create project.

Paste the following code before the </mule> tag.

<http:listener-config name="HTTP_Listener_config">
  <http:listener-connection host="${}" port="${http.listener.port}" />
<configuration-properties file="${env}.properties" doc:name="Configuration properties" />
<flow name="test-flow">
  <http:listener path="hello" config-ref="HTTP_Listener_config" doc:name="Listener" doc:id="lbryit" />
  <set-payload value="Hello World" doc:name="Set payload" doc:id="tggriu" />

This will create an HTTP Listener and a Set Payload component in the flow. You will also create two Global Element Configurations: one for the HTTP Listener configuration and another for the properties, in this case, using the ${env}.properties syntax.

ℹ️ Note You can use .properties or .yaml extensions for your properties files.

Create a new file under src/main/resources and paste the following properties:

ℹ️ Note You should have a different properties file per environment. For now, we are only creating the basic configuration for the dev environment to demonstrate.

Add arguments to the runtime

Once you have the basic setup to run the Mule app, we'll now add the env argument to the list. So, every time you run this Mule app, the env property will be provisioned to the runtime.

Open the ACB Settings by clicking on the ⚙️ icon on the home screen.

Open ACB Settings from Anypoint Code Builder's welcome home image

Go to Mule > Runtime: Default Arguments and append the following argument at the end of the value.


Mule > Runtime: Default Arguments. Default command line arguments used to start Mule Runtime Engine

Run your app locally

You can start your Mule app from the Run and Debug tab and click on the green run button.

Preview of the Run and Debug tab in Visual Studio Code to run your Mule application

Finally, call your Mule application from your REST Client with the following URL:


You should receive a "Hello World" response.

Thunder Client for VS Code running localhost8081/hello and receiving a Hello World response after the Mule app has been deployed


I hope that was helpful. Please comment below if you have any questions.

Subscribe to receive notifications as soon as new content is published ✨

💬 Prost! 🍻

538 views0 comments


bottom of page