All docs This doc

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


  • Install JDK and set up the JAVA_HOME environment variable. For more information, see Installation Prerequisites.
  • Download and install a service wrapper library to use for running your WSO2 product as a Windows service. WSO2 recommends Yet Another Java Service Wrapper (YAJSW) version 11.03, and several WSO2 products provide a default wrapper.conf file in their <PRODUCT_HOME>/bin/yajsw/ directory. The instructions below describe how to set up this file.


The configuration file used for wrapping Java Applications by YAJSW is wrapper.conf, which is located in the <YAJSW_HOME>/conf/ directory and in the <PRODUCT_HOME>/bin/yajsw/ directory of many WSO2 products. Following is the minimal wrapper.conf configuration for running a WSO2 product as a Windows service. Open your wrapper.conf file, set its properties as follows, and save it in <YAJSW_HOME>/conf/ directory.


If you are using ESB 4.9.0, you must manually add the following property to the wrapper.conf file to avoid errors in the management console:

Code Block = -Dorg.apache.jasper.compiler.Parser.STRICT_QUOTE_ESCAPING=false

If this property is not added, you may come across an exception that will result in blank pages when you log on to the management console.


If you want to set additional properties from an external registry at runtime, store sensitive information like usernames and passwords for connecting to the registry in a properties file and secure it with secure vault.


Extract the Carbon-based product that you want to run as a Windows service, and then set the Windows environment variable CARBON_HOME to the extracted product directory location. For example, if you want to run ESB 4.59.0 as a Windows service, you would set CARBON_HOME to the extracted wso2esb-4.59.0 directory.Image Removed

Running the product in console mode

You will now To verify that YAJSW is configured correctly for running the Carbon-based product as a Windows service.


If the configurations are set properly for YAJSW, you will see a console output similar to the following and can now access the WSO2 management console from your web browser via https://localhost:9443/carbon.