Skip to content
An open source, a high-performance hybrid integration platform that allows developers quick integration with any application, data, or system.
Java JavaScript Shell TSQL CSS Batchfile Other
Branch: master
Clone or download

WSO2 Enterprise Integrator

Build Status License Twitter

WSO2 Enterprise Integrator

WSO2 Enterprise Integrator is an open source, fast, cloud native and scalable integration solution that is the core of WSO2 Integration Agile Platform. It enables enterprise integration developers to build sophisticated integration solutions to achieve digital agility. As a mature integration product since 2005, (branded as WSO2 ESB at the time), it continues to be the most sophisticated and extensible open source enterprise integration solution available.

Actively maintained, with commercial support from WSO2 Inc, WSO2 Enterprise Integrator is widely used in production at companies around the globe starting from startups to fortune 500 companies in the fields of government, healthcare, banking, education, communication, etc.

Installation | Documentation | Mailing Lists | Blog | Support | Nightly Builds


Why WSO2 Enterprise Integrator

WSO2 Enterprise Integrator is an open source, hybrid integration platform. It is comprised of profiles that address different parts of a complete integration story.

Enterprise Service Bus profile: If you are trying to interconnect your enterprise applications on-premise, legacy or cloud, WSO2 EI can act as a Service Bus. It can help transforming messages to different formats, standards, use different protocols to communicate and mediating messages across the applications. With 100+ ready made cloud connectors, intuitive tooling, analytic capabilities WSO2 EI provides a greater agility to meet growing and changing enterprise demands. It can also accelerate bringing your enterprise data to the screen by exposing them as services, APIs.

Message Broker profile: This allows for queueing of messages (using the AMQP protocol) where you do not require an immediate response to continue processing. WSO2 EI acts as a Message Broker server.

Business-process profile: If your integration story contains human interactions (i.e., approval process) or stateful integration/orchestration, WSO2 EI provides BPEL/BPMN and human task capabilities to develop work-flows.

Analytics profile: Provides time-based/count-based analytics, stats, and monetization capability at different points of your integration flow implemented by combining the above profiles.

All above aspects are seamlessly cross-supportive and, together, makes WSO2 EI a complete powerful middleware solution that helps you to digitalize your business with more agility.

WSO2 EI has a cloud native offering as well named WSO2 Micro Integrator that enables developers implement composite microservices and integrate them. It contains a microservices friendly implementation of Enterprise Service Bus profile.

WSO2 Enterprise Integrator


  • Support for all EIP Patterns: Integrate applications following standard enterprise integration patterns
  • Faster message mediation: Passthrough HTTP Transport for faster message mediation through WSO2 EI
  • Supports multiple transports/messaging standards: Interconnect applications that support different protocols (i.e., HTTP and JMS)
  • Supports numerous formats and protocols: Interconnect applications that work with different message formats (i.e., XML and Json)
  • As a gateway : Front operations within the operations as a managed, secured proxy services/APIs.
  • Offer QOS to services/APis: Supports throttling, caching responses for faster mediation, circuit breaking, applying security
  • Secure enterprise: Apply Oauth 2.0, Saml SSO, Keberos for services/APIs. WS-security support for proxy services
  • Service orchestration: Enable to interconnect a set of APIs and web services and expose them as a single API or a web service
  • Database integration: Enable to expose data as services and APIs, stream data and listen for data changes and trigger events
  • Handle many concurrent HTTP(S) connections: Ability to serve multiple HTTP connections concurrently using reactor pattern and Java NIO
  • Event publishing, logging and auditing: Server logs, audit logs, trace logs with information of executions within server to different levels and ability to integrate with popular log analytic software
  • 185+ connectors: Connecting Web APIs / Cloud services with on-premise enterprise applications
  • Expose enterprise data as APIs/Services: Use data services to expose queries/stored procedures as APIs/Services. Transactions supported.
  • Visual data mapping: Map input data formats to output data formats visually, flexibility to change message structure within enterprise is never made easier
  • Guaranteed delivery of messages: WSO2 EI is configurable with message broker profile (OOB) and with any JMS broker to construct asynchronous messaging patterns with GD.
  • Periodic task execution: Execute a periodic task, invoke a message flow periodically, handle a bulk load at off peak time.
  • Connecting with Packaged applications: Integration with systems like SAP
  • Business processes and human tasks: Ability to handle message flows those involves a human interaction, approval process in a standard manner.
  • Data analytic, monetization capabilities: Ability to measure number of hits to APIs/proxies, geographic information, know what is used most by your users.

For more about WSO2 EI extension points visit here. Please find the full available connectors at WSO2 Store.


WSO2 EI is packaged in several forms for different platforms and environments. However, the bare metal form is the Binary Zip file:

  • WSO2 EI Zip: Works on any platform, just unzip and run
Platform OS Infrastructure Mgt
WSO2 EI AWS CloudFormation WSO2 EI installer for Windows WSO2 EI Puppet Install
WSO2 EI Kubernetes WSO2 EI installer for Mac WSO2 EI Ansible Install
WSO2 EI Docker WSO2 EI installer for Ubuntu
WSO2 EI Vagrant WSO2 EI installer for CentOS
WSO2 EI Helm
WSO2 EI YUM Install
WSO2 EI Brew Install
WSO2 EI Apt Install
  • WSO2 Micro Integrator is the cloud-native offering of WSO2 EI. It is a configuration driven runtime that helps developers implement composite microservices.

Installation and Run

Extract and navigate to extracted directory/bin. From there, start the preferred profile. After started, Management console will be accessible for the profile started. Use username:admin and password:admin to access the console.

Profile Web Console Url
Integrator (ESB) https://localhost:9443/carbon
Broker https://localhost:9446/carbon
Business process https://localhost:9445/carbon
Analytics https://localhost:9643/portal

All open issues pertaining to WSO2 Enterprise Integrator are reported at the following location: known issues

Artifact Development

Use WSO2 EI tooling for artifact development to be deployed and run on WSO2 EI. It is a powerful, visual editor for developing WSO2 EI integration artifacts that enables you to structure the whole enterprise integration solution to a single project and export it as a single deployable unit. A team can push the project on GitHub and collaboratively work on developing integration flows.

Read on how to develop integration artifacts with EI tooling here.

Test Artifacts in the Enterprise Integrator

WSO2 Enterprise Integrator allows you to execute unit tests against your integration artifacts by using Synapse Unit Testing Framework.

Building from Source

If you intend to build the project from the source you can do that with or without building the dependent projects. Here is an outline how the dependent project are structured. If you build with dependencies, you need to do it from bottom to top in the hierarchy.

WSO2 EI-Repositories

Repositories referred above

Enterprise Support

Enterprise support for WSO2 EI is provided by WSO2. Learn more here.


Copyright (c) 2019, WSO2 Inc. ( All Rights Reserved.

WSO2 Inc. licenses this file to you under the Apache License,
Version 2.0 (the "License"); you may not use this file except
in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
You can’t perform that action at this time.