Skip to content

Releases: asgardeo/thunder

Thunder v0.22.0

13 Feb 11:51
@github-actions github-actions
v0.22.0
4f638f6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.22.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

✨ Improvements

🐛 Bug Fixes

New Contributors

Full Changelog: v0.21.0...v0.22.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.22.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.22.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.22.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.22.0-macos-x64.zip
    Linux x64 thunder-0.22.0-linux-x64.zip
    Linux ARM64 thunder-0.22.0-linux-arm64.zip
    Windows x64 thunder-0.22.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.22.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.22.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.22.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.22.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.22.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.22.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.22.0-linux-arm64.zip
    Windows x64 [sample-app-react-vanilla-0.22.0-win-x64.zip](https://gith...
Read more

Contributors

brionmario, himeshsiriwardana, and 8 other contributors
Loading

Thunder v0.21.0

06 Feb 14:16
@github-actions github-actions
v0.21.0
1872666
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.21.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

🚀 Features

✨ Improvements

  • Add unit tests for thunder-gate app by @DonOmalVindula in #1255
  • refactor: migrate from UUIDv4 to UUIDv7 across all resources by @priyanshoon in #1235
  • Add required_attributes support for OAuth and auth assertion executor by @thiva-k in #1258
  • Unify passkey authentication and registration flow graph handles by @KaveeshaPiumini in #1287
  • Role service context propagation and transection usage by @JeethJJ in #1279
  • Generate separate key pair for digital signatures by @Copilot in #1131
  • React Vanilla Sample App Improvements for Passkey by @KaveeshaPiumini in #1293
  • Introduce claims support for OAuth flows by @thiva-k in #1288

🐛 Bug Fixes

New Contributors

Full Changelog: v0.20.0...v0.21.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.21.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.21.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.21.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.21.0-macos-x64.zip
    Linux x64 thunder-0.21.0-linux-x64.zip
    Linux ARM64 thunder-0.21.0-linux-arm64.zip
    Windows x64 thunder-0.21.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.21.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.21.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.21.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.21.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.21.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.21.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.21.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.21.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.21.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.21.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-sdk-0.21.0-macos-x64.zip
    Linux x64 sample-app-react-sdk-0.21.0-linux-x64.zip
    Linux ARM64 sample-app-react-sdk-0.21.0-linux-arm64.zip
    Windows x64 sample-app-react-sdk-0.21.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-sdk-0.21.0-<os>-<arch>.zip
cd sample-app-react-sdk-0.21.0-<os>-<arch>/

  3. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration and troubleshooting.

Self Register and Login (...
Read more

Contributors

brionmario, ThaminduDilshan, and 6 other contributors
Loading

Thunder v0.20.0

30 Jan 08:45
@github-actions github-actions
v0.20.0
5df88a4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.20.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

  • Rename from immutable resources to declarative resources by @rajithacharith in #1182
  • Improve Passkey Authentication by Enabling Attribute-Based User Identification by @KaveeshaPiumini in #1203
  • Improve default attributes handling in flows and oauth by @thiva-k in #1248

🚀 Features

✨ Improvements

🐛 Bug Fixes

  • Fix bootstrap scripts to fetch OUs by handle instead of picking first from list by @rajithacharith in #1169
  • Fix auto-login after self-registration by @thiva-k in #1170
  • Add leeway for time claims in token validation by @thiva-k in #1189
  • Fix the ID Token Validation issues due to invalid Issuer configured in the SDK by @brionmario in #1232

Full Changelog: v0.19.0...v0.20.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.20.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.20.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.20.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.20.0-macos-x64.zip
    Linux x64 thunder-0.20.0-linux-x64.zip
    Linux ARM64 thunder-0.20.0-linux-arm64.zip
    Windows x64 thunder-0.20.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.20.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.20.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.20.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.20.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.20.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.20.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.20.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.20.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.20.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.20.0-macos-arm64.zip
    macOS x64 (Intel) [sample-app-react-sdk-0.20.0-macos-x64.zip](https://githu...
Read more

Contributors

brionmario, rajithacharith, and 5 other contributors
Loading

Thunder v0.19.0

23 Jan 08:55
@github-actions github-actions
v0.19.0
bdf95d5
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.19.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

🚀 Features

✨ Improvements

🐛 Bug Fixes

Full Changelog: v0.18.0...v0.19.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.19.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.19.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.19.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.19.0-macos-x64.zip
    Linux x64 thunder-0.19.0-linux-x64.zip
    Linux ARM64 thunder-0.19.0-linux-arm64.zip
    Windows x64 thunder-0.19.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.19.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.19.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.19.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.19.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.19.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.19.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.19.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.19.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.19.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.19.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-sdk-0.19.0-macos-x64.zip
    Linux x64 sample-app-react-sdk-0.19.0-linux-x64.zip
    Linux ARM64 [sample-app-react-sdk-0.19.0-linux-arm64.zip](https://github.com/asgardeo/thunder/releases/down...
Read more

Contributors

darshanasbg, brionmario, and 7 other contributors
Loading

Thunder v0.18.0

16 Jan 07:41
@github-actions github-actions
v0.18.0
a8504fc
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.18.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

🚀 Features

  • Add Atomic API based Passkey Registration and Authentication Support by @KaveeshaPiumini in #987
  • Add transaction management infrastructure by @JeethJJ in #976

✨ Improvements

🐛 Bug Fixes

Full Changelog: v0.17.0...v0.18.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.18.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.18.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.18.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.18.0-macos-x64.zip
    Linux x64 thunder-0.18.0-linux-x64.zip
    Linux ARM64 thunder-0.18.0-linux-arm64.zip
    Windows x64 thunder-0.18.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.18.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.18.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.18.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.18.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.18.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.18.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.18.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.18.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.18.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.18.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-sdk-0.18.0-macos-x64.zip
    Linux x64 sample-app-react-sdk-0.18.0-linux-x64.zip
    Linux ARM64 sample-app-react-sdk-0.18.0-linux-arm64.zip
    Windows x64 sample-app-react-sdk-0.18.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-sdk-0.18.0-<os>-<arch>.zip
cd sample-app-react-sdk-0.18.0-<os>-<arch>/

  3. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration and troubleshooting.

Self Register and Login (React Vanilla Sample)

The React Vanilla sample supports user self-registration and login:

  1. Open https://localhost:3000 and click "Sign up" to register a new user.

    Self Registration Username Password

  2. After registration, use the same credentials to "Sign In".

    Login to Sample App

  3. Upon successful login, you'll see the h...

Read more

Contributors

darshanasbg, brionmario, and 6 other contributors
Loading

Thunder v0.17.0

09 Jan 11:13
@github-actions github-actions
v0.17.0
4da8fb8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.17.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

🚀 Features

✨ Improvements

🐛 Bug Fixes

Full Changelog: v0.16.0...v0.17.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.17.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.17.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.17.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.17.0-macos-x64.zip
    Linux x64 thunder-0.17.0-linux-x64.zip
    Linux ARM64 thunder-0.17.0-linux-arm64.zip
    Windows x64 thunder-0.17.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.17.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.17.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.17.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.17.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.17.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.17.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.17.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.17.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.17.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.17.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-sdk-0.17.0-macos-x64.zip
    Linux x64 sample-app-react-sdk-0.17.0-linux-x64.zip
    Linux ARM64 sample-app-react-sdk-0.17.0-linux-arm64.zip
    Windows x64 sample-app-react-sdk-0.17.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-sdk-0.17.0-<os>-<arch>.zip
cd sample-app-react-sdk-0.17.0-<os>-<arch>/

  3. Start the sample

    ./start....
Read more

Contributors

senthalan, brionmario, and 7 other contributors
Loading

Thunder v0.16.0

24 Dec 06:27
@github-actions github-actions
v0.16.0
7b76859
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.16.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

🚀 Features

✨ Improvements

🐛 Bug Fixes

Full Changelog: v0.15.0...v0.16.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.16.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.16.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.16.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.16.0-macos-x64.zip
    Linux x64 thunder-0.16.0-linux-x64.zip
    Linux ARM64 thunder-0.16.0-linux-arm64.zip
    Windows x64 thunder-0.16.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.16.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.16.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) [sample-app-react-vanilla-0.16.0-macos-arm64.zip](https://github.com/asgardeo/thunder/rele...
Read more

Contributors

darshanasbg, senthalan, and 9 other contributors
Loading

Thunder v0.15.0

13 Dec 17:54
@github-actions github-actions
v0.15.0
b56c5c6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.15.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

✨ Improvements

🐛 Bug Fixes

Full Changelog: v0.14.0...v0.15.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.15.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.15.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.15.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.15.0-macos-x64.zip
    Linux x64 thunder-0.15.0-linux-x64.zip
    Linux ARM64 thunder-0.15.0-linux-arm64.zip
    Windows x64 thunder-0.15.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.15.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.15.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.15.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.15.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.15.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.15.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.15.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.15.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.15.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.15.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.15.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-sdk-0.15.0-macos-x64.zip
    Linux x64 sample-app-react-sdk-0.15.0-linux-x64.zip
    Linux ARM64 sample-app-react-sdk-0.15.0-linux-arm64.zip
    Windows x64 sample-app-react-sdk-0.15.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-sdk-0.15.0-<os>-<arch>.zip
cd sample-app-react-sdk-0.15.0-<os>-<arch>/

  3. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration and troubleshooting.

Self Register and Login (React Vanilla Sample)

The React Vanilla sample supports user self-registration and login:

  1. Open https://localhost:3000 and click "Sign up" to register a new user.

    Self Registration Username Password

  2. After registration, use the same credentials to "Sign In".

    Login to Sample App

  3. Upon successful login, you'll see the home page with your access token.

Try Out Client Credentials Flow

To try out the Client Credentials flow, you first need to obtain a token to access the System APIs of Thunder. Follow these steps:

Replace `<applicatio...

Read more

Contributors

senthalan, brionmario, and 4 other contributors
Loading

Thunder v0.14.0

05 Dec 19:17
@github-actions github-actions
v0.14.0
faaac13
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.14.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

🚀 Features

  • Add Resource API definition and Implementation by @senthalan in #666

✨ Improvements

New Contributors

Full Changelog: v0.13.0...v0.14.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.14.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.14.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.14.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.14.0-macos-x64.zip
    Linux x64 thunder-0.14.0-linux-x64.zip
    Linux ARM64 thunder-0.14.0-linux-arm64.zip
    Windows x64 thunder-0.14.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.14.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.14.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker Compose

Follow these steps to run WSO2 Thunder using Docker Compose.

  1. Download the Docker Compose file

    Download the docker-compose.yml file using the following command:

    curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.14.0/install/quick-start/docker-compose.yml

  2. Start Thunder

    Run the following command in the directory where you downloaded the docker-compose.yml file:

    docker compose up

    This will automatically:

    • Initialize the database
    • Run the setup process
    • Start the Thunder server

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id> in the setup logs. You'll need it for the sample app configuration.

    The product will start on https://localhost:8090.

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without external SDKs. Supports Native Flow API or Standard OAuth/OIDC.
  • React SDK Sample — Sample React application demonstrating SDK-based integration using @asgardeo/react for OAuth 2.0/OIDC authentication.
React Vanilla Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.14.0-macos-arm64.zip
    macOS x64 (Intel) sample-app-react-vanilla-0.14.0-macos-x64.zip
    Linux x64 sample-app-react-vanilla-0.14.0-linux-x64.zip
    Linux ARM64 sample-app-react-vanilla-0.14.0-linux-arm64.zip
    Windows x64 sample-app-react-vanilla-0.14.0-win-x64.zip

  2. Unzip and navigate to the sample app directory

    unzip sample-app-react-vanilla-0.14.0-<os>-<arch>.zip
cd sample-app-react-vanilla-0.14.0-<os>-<arch>/

  3. Configure the sample

    Open app/runtime.json and set the applicationID to the sample app ID generated during "Setup the product":

    {
    "applicationID": "{your-application-id}"
}

  4. Start the sample

    ./start.sh

    Open your browser and navigate to https://localhost:3000 to access the sample app.

    📖 Refer to the README.md inside the extracted sample app for detailed configuration options including OAuth redirect-based login.

React SDK Sample

  1. Download the sample

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) [sample-app-react-sdk-0.14.0-macos-arm64.zip](https://github.com/asgardeo/th...
Read more

Contributors

senthalan, sahandilshan, and 8 other contributors
Loading

Thunder v0.13.0

28 Nov 17:39
@github-actions github-actions
v0.13.0
55c7f6c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Thunder v0.13.0 Pre-release
Pre-release

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

What's Changed

⚠️ Breaking Changes

🚀 Features

✨ Improvements

🐛 Bug Fixes

New Contributors

Full Changelog: v0.12.0...v0.13.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.13.0 release of WSO2 Thunder and run it locally.

  1. Download the distribution from the 0.13.0 release

    OS Architecture Download Link
    macOS ARM64 (Apple Silicon) thunder-0.13.0-macos-arm64.zip
    macOS x64 (Intel) thunder-0.13.0-macos-x64.zip
    Linux x64 thunder-0.13.0-linux-x64.zip
    Linux ARM64 thunder-0.13.0-linux-arm64.zip
    Windows x64 thunder-0.13.0-win-x64.zip

  2. Unzip the product

    Unzip the downloaded file using the following command:

    unzip thunder-0.13.0-<os>-<arch>.zip

    Navigate to the unzipped directory:

    cd thunder-0.13.0-<os>-<arch>/

  3. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

    If you are using a Linux or macOS machine:

    ./setup.sh

    If you are using a Windows machine:

    .\setup.ps1

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

  4. Start the product

    If you are using a Linux or macOS machine:

    ./start.sh

    If you are using a Windows machine:

    .\start.ps1

    The product will start on https://localhost:8090.

Option 2: Run with Docker

Follow these steps to run WSO2 Thunder using Docker.

  1. Pull the Docker image

    docker pull ghcr.io/asgardeo/thunder:0.13.0

  2. Setup the product

    You need to setup the server with the initial configurations and data before starting the server for the first time.

        docker run -it --rm \
        ghcr.io/asgardeo/thunder:0.13.0 \
        ./setup.sh

    Note the id of the sample app indicated with the log line [INFO] Sample App ID: <id>. You'll need it for the sample app configuration.

    [!NOTE]
    This will shut down the container after the setup is complete. You need to start the container again using the command in step 3. If you are using sqlite as the database, then you need to mount a volume to persist the database file and share it between the setup and server run containers.

  3. Run the container

    docker run --rm \
  -p 8090:8090 \
  ghcr.io/asgardeo/thunder:0.13.0

    Optionally if you want to modify the server configurations, you can mount a custom deployment.yaml file. Create a deployment.yaml file in your working directory similar to the deployment.yaml, and mount it as below:

    docker run --rm \
  -p 8090:8090 \
  -v $(pwd)/deployment.yaml:/opt/thunder/repository/conf/deployment.yaml \
  ghcr.io/asgardeo/thunder:0.13.0

    Optionally if you want to use custom configurations or certificates, you can mount them as follows:

    docker run --rm \
  -p 8090:8090 \
  -v $(pwd)/deployment.yaml:/opt/thunder/repository/conf/deployment.yaml \
  -v $(pwd)/certs/server.cert:/opt/thunder/repository/resources/security/server.cert \
  -v $(pwd)/certs/server.key:/opt/thunder/repository/resources/security/server.key \
  ghcr.io/asgardeo/thunder:0.13.0

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

  1. Open your browser and navigate to https://localhost:8090/develop.

  2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

Thunder provides two sample applications to help you get started quickly:

  • React Vanilla Sample — Sample React application demonstrating direct API integration without exte...
Read more

Contributors

darshanasbg, jeradrutnam, and 7 other contributors
Loading