Skip to content

Quick Setup

Follow the steps given below to set up and install WSO2 Identity Server (WSO2 IS) on your computer in quick time.


For detailed instructions on other installation options and deployments, see the installation guide.

Install WSO2 IS

Follow the steps given below.

  1. Download and install Java SE Development Kit (JDK) version 11 or 17.


    Learn more about JDK compatibility in WSO2 Identity Server 6.1.0.

  2. Go to the WSO2 Identity Server website and click Get Started.

  3. Install WSO2 Identity Server by downloading the LATEST BINARY RELEASE.


    The installation location of WSO2 Identity Server is referred to as <IS_HOME>.

Configure the server

Open the deployment.toml file (stored in the <IS_HOME>/repository/conf folder) and add the following configuration to enable CORS:

allow_generic_http_requests = true
allow_any_origin = true
supported_methods = [
supports_credentials = false
max_age = 3600
tag_requests = false

Start WSO2 IS

To start WSO2 IS, open a terminal, navigate to the <IS_HOME>/bin folder, and execute one of the following commands:

  • On Linux/MacOS

  • On Windows


Note that the following log appears in the command prompt when the server starts:

QSG start server

Shutting down the server

To shut down the server, press Ctrl + C. Note that the following log appears in the command prompt on server shutdown.

QSG stop server

What's next?

Try out the sample IAM scenarios to get familiar with WSO2 IS and its capabilities.