WSO2 4 min

Downloading a WSO2 Product

Rob Blaauboer
Rob Blaauboer
Integration Consultant & WSO2 Trainer
download a wso2 product computer

downloading a wso2 product - computerWhen you want to try out a WSO2 product, one of the first steps is getting hold of the product itself. The days of products on floppy disks, CD’s and DVD’s are long gone so you must download it from the WSO2 website. Recently there have been substantial changes to the WSO2 Update Manager, the Subscription offerings and so on. In this blog, we look at the changes and the possibilities you have downloading the product either as open source or WSO2 subscription.

But let’s us refresh your mind, what are the core products of WSO2 again? This image explains.

WSO2 products

The main four (or Big 4 as I like to call them) WSO2 products are: API Manager, Integration, Analytics and Identity  & Access Management and all those products will get be available as multiple downloads. The Docker, Vagrant and WUM options are only available for Subscribers. We will cover the Docker and Vagrant options in another blog.  

Options galore

This is the overview of the API Manager version 2.1.0

Install WSO2 API Manager 2.1.0

The downloader now offers two options.

WSO2 API Manager 2.1.0 downloader


Sign up for WSO2 subscription

The top half of the image is the download option for organizations with a WSO2 Subscription, tied to an email address of the registered user / downloader. Without an active subscription you will be warned so and asked to sign up. Keep in mind that business addresses (tied to an organization) are eligible for a 15-day trial.

The bottom half is for open source users that do need to leave an email address and company name but does not require a Support Contract or an agreement with WSO2.

In this blog we look at the downloader and WUM as the two distribution methods.

Where is the ESB?

Older versions of other software, so called legacy products, are still downloadable using the regular zip file download. While the latest version of Enterprise Integrator is actually a bundling of a number of products like the Enterprise Service bus, now called the Enteprise Integration Profile, the last version of the standalone ESB 5.0.0  and can be found at the Enterprise Integrator Previous Releases.

There have been products that are not listed in under the older versions (as shown above) or on the products page. If you are looking for older products or older versions not listed, Google is your best bet. Enter the keywords in Google and you hopefully find the version you are looking for.

One version for all?

WSO2 products can be used for free. Yes, free! Nothing to pay, no lawyers hunting you down. However, a WSO2 Subscription provides additional value, such as security and bug-fix updates, 24×7 support SLA and other services that provide enterprise-class support, which require a paid subscription contract.

I will not go into details what these contracts entail, contact Yenlo if you have any questions about support (in the broad sense of the word).

As said, after a free trial you need to revert to open source if you do not want a support contract and would like to use the product.

The zip file download is the available free for all versions of the products that can be downloaded and used by everyone. Products that are later patched, as part of the download or an update using WUM can only be used in production with a WSO2 Subscription Contract.  These patches are distributed via WSO2 Update Manager (WUM) or, nowadays, also as updates using the new installer or any of the other distribution types.


New versions of WSO2 products can be downloaded and updated using WSO2 Update Manager (WUM) version 2.0. A check on eligibility is performed as part of the update process.

WUM Command Prompt

This is the list as of April 5th 2018. As you can see it has several versions of the big 5 and some other often used products like Governance Registry. WUM allows you to download a product and check for updates and when updates are available automatically update the product, resulting in a new patched zip file.

That file is then no longer an open source product since patches have been installed that are supplied under the license of a product support contract. This can lead to a warning given when checking for updates.

WUM is easy to use, for installation guide read this blog on WUM written my colleague Domenique. It is an older version (v1) but the principle is the same. Alternatively, you can follow the instructions on the WSO2 website.

But, to show how WUM works:

wum init

is used to initialize the WUM repository with your WSO2 registered email address (that is also checked with regards to linked product support contract

wum add wso2is-5.4.1

Adds wso2is-5.4.1 to the local repository

wum check-update wso2is-5.4.1

Checks for updates

wum update wso2is-5.4.1

Updates the product


The software is downloaded as the baseline version and separately the patches are downloaded and installed. All patches are copied over the baseline and cannot be uninstalled. This is a difference to the previous patched process that allowed for deinstallation.

After installation you need to apply all your own deployment specific settings and tweaks.

Zip download and Windows/Linux Installer

As said, downloading the zip file, in the image the Download Server button will get you the zip file that just needs to be unzipped and, when Java is installed and JAVA_HOME is set, you are good to go.

Full API lifecycle Management Selection Guide

whitepaper hero
Get it now