This documentation is for WSO2 Enterprise Service Bus 3.0.0. View documentation for the latest release.

Versions Compared


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


Confirm that the designated machine meets the following requirements:


No minimum requirements.
A heap size of 256~512MB is generally sufficient to process typical SOAP messages.
Requirements may vary with larger message size and on the number of messages processed concurrent.


No minimum requirements.
The installation will require ~125 MB excluding space allocated for log files and Databases.

Operating System

Linux, Solaris, MS Windows - XP/ Vista (Not fully tested on Windows Vista).
As WSO2 ESB is a Java application, it is generally possible to run it on other operating systems with a JDK 1.5.x runtime.
Linux/Solaris is recommended for a production deployment.

Required Applications

Prior to installing ESB, install the following software:




Installation Instructions

Java SE Development Kit (JDK)

  • To launch WSO2 ESB as it is a Java application.
  • To build WSO2 ESB from the Source distribution (both JDK and Apache Maven are required).
  • To run Apache Ant.



We do not recommend OpenJDK.

Apache ActiveMQ
JMS Provider

  • To enable the WSO2 ESB JMS transport and try out JMS samples. The ActiveMQ client libraries must be installed in the ESB classpath before you can enable the JMS transport.

4.1.0 or later

If you use any other JMS provider (e.g. Apache Qpid), install any necessary libraries and/or components.

Apache Ant

  • To compile and run the sample clients.

1.7.0 or later

Apache Maven

  • To build WSO2 ESB from the Source distribution (both JDK and Apache Maven are required).

2.1.0 to 3.0.x.

Mozilla Firefox

  • To access the ESB Management Console.

3.0 at a resolution of 1024x768 is recommended.

MS Internet Explorer 7 may be used as well, with some minor limitations.


Once the installation prerequisites have been completed, you can proceed to installing ESB. See: