Skip to content

Install SI

Follow the steps given below to install the WSO2 Integrator: SI.

System requirements

Type Requirement
CPU You require a minimum of one CPU with 2 cores. It is recommended to have a CPU with 4 cores.
Memory ~ 4 GB minimum is recommended

~ 2 GB heap size
Disk ~ 1 GB minimum (excluding space allocated for log files and databases.)

Download and install WSO2 Integrator

WSO2 Integrator bundles all WSO2 integrators in a single application; you access SI by switching profiles.

  1. Go to the WSO2 Integrator downloads page. Enter your email address and agree to the license — you will receive an email with a link to download the installer.

  2. Run the installer and open WSO2 Integrator. The home page opens with a Configure button in the top right corner.

    WSO2 Integrator home

  3. Click Configure, and under Select your Integration Profile, choose WSO2 Integrator: SI.

    Select SI profile

  4. WSO2 Integrator opens the SI setup page. WSO2 Integrator comes with Java 25, so Java is already set up. If the SI runtime is not detected, click Download WSO2 Integrator: SI to install it. If you already have the SI runtime installed, expand Advanced Options and click Select SI Path to point WSO2 Integrator at your existing SI installation directory.

    Download SI runtime

    Note

    If you use the WSO2 Integrator VS Code extension instead, the setup page also checks for Java. Install JDK 25 (JDK 17 and 21 are also supported), or let the setup page download it for you.

Locate SI_HOME

After installation, WSO2 Integrator places the SI runtime in a hidden folder under your user directory. The path varies by platform:

  • macOS/Linux: ~/.wso2-si/streaming-integrator/wso2si-<VERSION>/
  • Windows: C:\Users\<username>\.wso2-si\streaming-integrator\wso2si-<VERSION>\

This directory is referred to as <SI_HOME> throughout this documentation. Because it sits inside a dotfile-prefixed folder, your file browser may hide it by default — toggle "Show hidden files" (Cmd + Shift + . on macOS; View → Show → Hidden items in File Explorer on Windows) to see it.

Set JAVA_HOME

WSO2 Integrator: SI 4.4.1 supports JDK 17, 21 and 25. JDK 25 is recommended.

Set your JAVA_HOME environment variable to point to your JDK installation directory.

export JAVA_HOME=/path/to/your/jdk-25
To make the change persistent, add the line to your shell profile (e.g., ~/.zshrc or ~/.bashrc).

setx JAVA_HOME "C:\path\to\your\jdk-25"
Open a new command prompt for the change to take effect.

For full instructions and the latest JDK download, see the Oracle Java SE downloads page.

Starting the SI server

For day-to-day development, click Run in WSO2 Integrator and it manages the SI runtime for you. The commands below are for production-style deployments where you run SI standalone in a VM.

Follow the steps given below to start the server.

  1. Open a command prompt as explained below.
  2. Navigate to the <SI_HOME>/bin folder from your command line.
  3. Execute one of the commands given below.

    • To start the server:

      sh server.sh
      
      server.bat
      
    • To start the server in background mode:

      sh server.sh start
      
      server.bat --start
      

Stopping the SI server

  • To stop the WSO2 Integrator: SI standalone application, go to the terminal and press Ctrl+C.
  • To stop the WSO2 Integrator: SI in background mode:

    sh server.sh stop
    
    server.bat --stop
    

What's Next?

Once you have successfully downloaded and installed WSO2 Integrator: SI, you can proceed to do any of the following:

- If you were previously using WSO2 Stream Processor and want to migrate to WSO2 Integrator: SI, follow the instructions in Migrating from WSO2 Stream Processor.

- To deploy WSO2 Integrator: SI as a single-node deployment or a cluster (based on your requirements), see Deploying WSO2 Integrator: SI.

- To set up WSO2 Integrator: SI and make it ready to run in a production environment, see the Production Checklist.