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. 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. Run the installer and open WSO2 Integrator. The home page opens with a Configure button in the top right corner. Click Configure, and under Select your Integration Profile, choose WSO2 Integrator: SI. 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. 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. On macOS/LinuxOn Windows 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. Open a command prompt as explained below. Navigate to the <SI_HOME>/bin folder from your command line. Execute one of the commands given below. To start the server: On macOS/LinuxOn Windows sh server.sh server.bat To start the server in background mode: On macOS/LinuxOn Windows 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: On macOS/LinuxOn Windows 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.