MuleSoft Technical Guides

Steps and Commands for RTF Installation on self managed kubernetes

User MuleSoft Integration Team
Calendar April 06, 2023

Command Line Tools Installation:


  1. JDK 

OpenJDK 11 >

OpenJDK 8 >

2. Install Chocolatey on Windows 

a. Run a Powershell terminal as Administrator, then run Get-ExecutionPolicy. If it returns Restricted, then run Set-ExecutionPolicy AllSigned or Set-ExecutionPolicy Bypass -Scope Process.

b. Install the Chocolatey Package Manager, a.k.a `choco`:

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString(‘’))

  1. Install kubectl

choco install kubernetes-cli –version=1.24.10 –allow-downgrade -y

  1. Install rtfctl

curl -L -o rtfctl.exe

  1. Install Azure CLI MSI

Validate all tools are installed :

  • kubectl version –client –short 
  • rtfctl version –help
  • az

Azure KS Commands (Creating Kubernetes Cluster): 

Create a resource group in Azure.


az aks create –resource-group <<resourcegroup>> –name <<clustername>> –node-count 2 –generate-ssh-keys –kubernetes-version 1.24.9 –node-vm-size Standard_DS2_v2

  1. Check created clusters

az aks list

  1. GET CREDS (Get access credentials for a managed kubernetes cluster)

az aks get-credentials –resource-group <<resourcegroup>> –name <<clustername>>

  1. View Kubernetes config

kubectl config view

  1. Test connection to your cluster

kubectl get services


kubectl get nodes

Create Runtime Fabric Configuration in Runtime Manager

AND Get the Activation Code

RTF requires a separate license, so make sure you have a valid license


<<activation code>>

2.Validate the activation code:

rtfctl validate <<activation code>>

Examine existing components in Kubernetes cluster before RTF installation

  1. Install the RTF:

rtfctl install <<activation code>>


  1. Check the RTF Status:

rtfctl status

Now your RTF status should be activated in Runtime Manager

Apply associated Environment (as per requirement)

Insert Mule License Key

1.Encode Mule license key

Powershell command to encode the license

$BASE64_ENCODED_LICENSE=[convert]::ToBase64String((Get-Content -path “license.lic” -Encoding byte))

2.set /p encoded_text=<mulel.txt   (In directory where encoded license present)

3.$encoded_text = Get-Content -Path “mulel.txt” -Raw (Run this command in Powershell)

4.rtfctl apply mule-license %encoded_text%

Now If you go to “Inbound Traffic”, you will see a Warning.

We need to configure Ingress in order to enable inbound traffic to our RTF cluster.

Define a custom ingress configuration

1. kubectl apply -f


kubectl apply -f ingress-resource.yaml

After configuring the ingress you will see the base endpoint as following:

Verify domains configured as base endpoints to runtime fabric

Deploy a Mule Application

  1. After deploying app to check the namespace of mule apps

kubectl get namespace

  1. To check services running on rtf

kubectl get services -n <<namespace>>

  1. To check pods running

kubectl get pods -n <<namespace>>


kubectl get ingress -n <<namespace>>




Leave a comment

Your email address will not be published. Required fields are marked *