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 Oracle Java SE Development Kit (JDK) version 11 or 17.
  2. . Go to WSO2 Identity Server official website and click on 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

    sh wso2server.sh
  • On Windows


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

QSG start server

Shutting down the server

To shutdown 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.