Releases: brionmario/thunder
ThunderID v0.39.0
ThunderID ⚡
Identity Management Suite
ThunderID 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, ThunderID integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.
Full Changelog: v0.38.0...v0.39.0
⚡ Quickstart
This Quickstart guide will help you get started with ThunderID 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 ThunderID
You can run ThunderID 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.39.0 release of ThunderID and run it locally.
-
Download the distribution from the 0.39.0 release
OS Architecture Download Link macOS ARM64 (Apple Silicon) thunderid-0.39.0-macos-arm64.zip macOS x64 (Intel) thunderid-0.39.0-macos-x64.zip Linux x64 thunderid-0.39.0-linux-x64.zip Linux ARM64 thunderid-0.39.0-linux-arm64.zip Windows x64 thunderid-0.39.0-win-x64.zip -
Unzip the product
Unzip the downloaded file using the following command:
unzip thunderid-0.39.0-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunderid-0.39.0-<os>-<arch>/
-
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. -
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 ThunderID using Docker Compose.
-
Download the Docker Compose file
Download the
docker-compose.ymlfile using the following command:curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.39.0/install/quick-start/docker-compose.yml
-
Start ThunderID
Run the following command in the directory where you downloaded the
docker-compose.ymlfile:docker compose up
This will automatically:
- Initialize the database
- Run the setup process
- Start the ThunderID 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 ThunderID Console
Follow these steps to access the ThunderID Console:
-
Open your browser and navigate to https://localhost:8090/console.
-
Log in using the admin credentials created during the initial data setup (
admin/admin).
Try Out with the Sample App
ThunderID 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/reactfor OAuth 2.0/OIDC authentication.
React Vanilla Sample
-
Download the sample
OS Architecture Download Link macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.39.0-macos-arm64.zip macOS x64 (Intel) sample-app-react-vanilla-0.39.0-macos-x64.zip Linux x64 sample-app-react-vanilla-0.39.0-linux-x64.zip Linux ARM64 sample-app-react-vanilla-0.39.0-linux-arm64.zip Windows x64 sample-app-react-vanilla-0.39.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-vanilla-0.39.0-<os>-<arch>.zip cd sample-app-react-vanilla-0.39.0-<os>-<arch>/
-
Configure the sample
Open
app/runtime.jsonand set theapplicationIDto the sample app ID generated during "Setup the product":{ "applicationID": "{your-application-id}" } -
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside the extracted sample app for detailed configuration options including OAuth redirect-based login.
React SDK Sample
-
Download the sample
OS Architecture Download Link macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.39.0-macos-arm64.zip macOS x64 (Intel) sample-app-react-sdk-0.39.0-macos-x64.zip Linux x64 sample-app-react-sdk-0.39.0-linux-x64.zip Linux ARM64 sample-app-react-sdk-0.39.0-linux-arm64.zip Windows x64 sample-app-react-sdk-0.39.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-sdk-0.39.0-<os>-<arch>.zip cd sample-app-react-sdk-0.39.0-<os>-<arch>/
-
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside 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:
-
Open https://localhost:3000 and click "Sign up" to register a new user.
-
After registration, use the same credentials to "Sign In".
-
Upon successful login, you'll see the home page with your access token.
Obtain System API Token
To access the system APIs of ThunderID, you need a token with system permissions. Follow the steps below to obtain a system API token.
- Run the following command, replacing
<application_id>with the sample app ID generated during "Setup the product."
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"applicationId":"<application_id>","flowType":"AUTHENTICATION"}'- Extract the
executionIdvalue from the response.
{"executionId":"<execution_id>","flowStatus":"INCOMPLETE", ...}- Run the following command, replacing
<execution_id>with theexecutionIdvalue you extracted above.
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"executionId":"<ex...ThunderID v0.38.0
ThunderID ⚡
Identity Management Suite
ThunderID 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, ThunderID integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.
Full Changelog: v0.36.0...v0.38.0
⚡ Quickstart
This Quickstart guide will help you get started with ThunderID 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 ThunderID
You can run ThunderID 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.38.0 release of ThunderID and run it locally.
-
Download the distribution from the 0.38.0 release
OS Architecture Download Link macOS ARM64 (Apple Silicon) thunderid-0.38.0-macos-arm64.zip macOS x64 (Intel) thunderid-0.38.0-macos-x64.zip Linux x64 thunderid-0.38.0-linux-x64.zip Linux ARM64 thunderid-0.38.0-linux-arm64.zip Windows x64 thunderid-0.38.0-win-x64.zip -
Unzip the product
Unzip the downloaded file using the following command:
unzip thunderid-0.38.0-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunderid-0.38.0-<os>-<arch>/
-
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. -
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 ThunderID using Docker Compose.
-
Download the Docker Compose file
Download the
docker-compose.ymlfile using the following command:curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.38.0/install/quick-start/docker-compose.yml
-
Start ThunderID
Run the following command in the directory where you downloaded the
docker-compose.ymlfile:docker compose up
This will automatically:
- Initialize the database
- Run the setup process
- Start the ThunderID 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 ThunderID Console
Follow these steps to access the ThunderID Console:
-
Open your browser and navigate to https://localhost:8090/console.
-
Log in using the admin credentials created during the initial data setup (
admin/admin).
Try Out with the Sample App
ThunderID 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/reactfor OAuth 2.0/OIDC authentication.
React Vanilla Sample
-
Download the sample
OS Architecture Download Link macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.38.0-macos-arm64.zip macOS x64 (Intel) sample-app-react-vanilla-0.38.0-macos-x64.zip Linux x64 sample-app-react-vanilla-0.38.0-linux-x64.zip Linux ARM64 sample-app-react-vanilla-0.38.0-linux-arm64.zip Windows x64 sample-app-react-vanilla-0.38.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-vanilla-0.38.0-<os>-<arch>.zip cd sample-app-react-vanilla-0.38.0-<os>-<arch>/
-
Configure the sample
Open
app/runtime.jsonand set theapplicationIDto the sample app ID generated during "Setup the product":{ "applicationID": "{your-application-id}" } -
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside the extracted sample app for detailed configuration options including OAuth redirect-based login.
React SDK Sample
-
Download the sample
OS Architecture Download Link macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.38.0-macos-arm64.zip macOS x64 (Intel) sample-app-react-sdk-0.38.0-macos-x64.zip Linux x64 sample-app-react-sdk-0.38.0-linux-x64.zip Linux ARM64 sample-app-react-sdk-0.38.0-linux-arm64.zip Windows x64 sample-app-react-sdk-0.38.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-sdk-0.38.0-<os>-<arch>.zip cd sample-app-react-sdk-0.38.0-<os>-<arch>/
-
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside 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:
-
Open https://localhost:3000 and click "Sign up" to register a new user.
-
After registration, use the same credentials to "Sign In".
-
Upon successful login, you'll see the home page with your access token.
Obtain System API Token
To access the system APIs of ThunderID, you need a token with system permissions. Follow the steps below to obtain a system API token.
- Run the following command, replacing
<application_id>with the sample app ID generated during "Setup the product."
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"applicationId":"<application_id>","flowType":"AUTHENTICATION"}'- Extract the
executionIdvalue from the response.
{"executionId":"<execution_id>","flowStatus":"INCOMPLETE", ...}- Run the following command, replacing
<execution_id>with theexecutionIdvalue you extracted above.
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"executionId":"<ex...Thunder v0.36.0
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.
Full Changelog: v0.20.0...v0.36.0
⚡ Quickstart
This Quickstart guide will help you get started with 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 Thunder
You can run 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.36.0 release of Thunder and run it locally.
-
Download the distribution from the 0.36.0 release
OS Architecture Download Link macOS ARM64 (Apple Silicon) thunder-0.36.0-macos-arm64.zip macOS x64 (Intel) thunder-0.36.0-macos-x64.zip Linux x64 thunder-0.36.0-linux-x64.zip Linux ARM64 thunder-0.36.0-linux-arm64.zip Windows x64 thunder-0.36.0-win-x64.zip -
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.36.0-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.36.0-<os>-<arch>/
-
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. -
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 Thunder using Docker Compose.
-
Download the Docker Compose file
Download the
docker-compose.ymlfile using the following command:curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.36.0/install/quick-start/docker-compose.yml
-
Start Thunder
Run the following command in the directory where you downloaded the
docker-compose.ymlfile: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 Thunder Console
Follow these steps to access the Thunder Console:
-
Open your browser and navigate to https://localhost:8090/console.
-
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/reactfor OAuth 2.0/OIDC authentication.
React Vanilla Sample
-
Download the sample
OS Architecture Download Link macOS ARM64 (Apple Silicon) sample-app-react-vanilla-0.36.0-macos-arm64.zip macOS x64 (Intel) sample-app-react-vanilla-0.36.0-macos-x64.zip Linux x64 sample-app-react-vanilla-0.36.0-linux-x64.zip Linux ARM64 sample-app-react-vanilla-0.36.0-linux-arm64.zip Windows x64 sample-app-react-vanilla-0.36.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-vanilla-0.36.0-<os>-<arch>.zip cd sample-app-react-vanilla-0.36.0-<os>-<arch>/
-
Configure the sample
Open
app/runtime.jsonand set theapplicationIDto the sample app ID generated during "Setup the product":{ "applicationID": "{your-application-id}" } -
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside the extracted sample app for detailed configuration options including OAuth redirect-based login.
React SDK Sample
-
Download the sample
OS Architecture Download Link macOS ARM64 (Apple Silicon) sample-app-react-sdk-0.36.0-macos-arm64.zip macOS x64 (Intel) sample-app-react-sdk-0.36.0-macos-x64.zip Linux x64 sample-app-react-sdk-0.36.0-linux-x64.zip Linux ARM64 sample-app-react-sdk-0.36.0-linux-arm64.zip Windows x64 sample-app-react-sdk-0.36.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-sdk-0.36.0-<os>-<arch>.zip cd sample-app-react-sdk-0.36.0-<os>-<arch>/
-
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside 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:
-
Open https://localhost:3000 and click "Sign up" to register a new user.
-
After registration, use the same credentials to "Sign In".
-
Upon successful login, you'll see the home page with your access token.
Obtain System API Token
To access the system APIs of Thunder, you need a token with system permissions. Follow the steps below to obtain a system API token.
- Run the following command, replacing
<application_id>with the sample app ID generated during "Setup the product."
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"applicationId":"<application_id>","flowType":"AUTHENTICATION"}'- Extract the
executionIdvalue from the response.
{"executionId":"<execution_id>","flowStatus":"INCOMPLETE", ...}- Run the following command, replacing
<execution_id>with theexecutionIdvalue you extracted above.
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"executionId":"<execution_id>", "inputs":{"username":"admin","password...Thunder v0.20.0
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.
Full Changelog: v0.0.16...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.
-
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 -
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>/
-
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. -
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.
-
Download the Docker Compose file
Download the
docker-compose.ymlfile using the following command:curl -o docker-compose.yml https://raw.githubusercontent.com/asgardeo/thunder/v0.16.0/install/quick-start/docker-compose.yml
-
Start Thunder
Run the following command in the directory where you downloaded the
docker-compose.ymlfile: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:
-
Open your browser and navigate to https://localhost:8090/develop.
-
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/reactfor OAuth 2.0/OIDC authentication.
React Vanilla Sample
-
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 -
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>/
-
Configure the sample
Open
app/runtime.jsonand set theapplicationIDto the sample app ID generated during "Setup the product":{ "applicationID": "{your-application-id}" } -
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside the extracted sample app for detailed configuration options including OAuth redirect-based login.
React SDK Sample
-
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 Linux x64 sample-app-react-sdk-0.20.0-linux-x64.zip Linux ARM64 sample-app-react-sdk-0.20.0-linux-arm64.zip Windows x64 sample-app-react-sdk-0.20.0-win-x64.zip -
Unzip and navigate to the sample app directory
unzip sample-app-react-sdk-0.20.0-<os>-<arch>.zip cd sample-app-react-sdk-0.20.0-<os>-<arch>/
-
Start the sample
./start.sh
Open your browser and navigate to https://localhost:3000 to access the sample app.
📖 Refer to the
README.mdinside 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:
-
Open https://localhost:3000 and click "Sign up" to register a new user.
-
After registration, use the same credentials to "Sign In".
-
Upon successful login, you'll see the home page with your access token.
Obtain System API Token
To access the system APIs of Thunder, you need a token with system permissions. Follow the steps below to obtain a system API token.
- Run the following command, replacing
<application_id>with the sample app ID generated during "Setup the product."
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"applicationId":"<application_id>","flowType":"AUTHENTICATION"}'- Extract the
flowIdvalue from the response.
{"flowId":"<flow_id>","flowStatus":"INCOMPLETE", ...}- Run the following command, replacing
<flow_id>with theflowIdvalue you extracted above.
curl -k -X POST 'https://localhost:8090/flow/execute' \
-d '{"flowId":"<flow_id>", "inputs":{"username":"admin","password"...Thunder v0.0.16
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
⚡ 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.0.16 release of WSO2 Thunder and run it locally.
- Download the distribution from the 0.0.16 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | thunder-0.0.16-macos-arm64.zip |
| macOS | x64 (Intel) | thunder-0.0.16-macos-x64.zip |
| Linux | x64 | thunder-0.0.16-linux-x64.zip |
| Linux | ARM64 | thunder-0.0.16-linux-arm64.zip |
| Windows | x64 | thunder-0.0.16-win-x64.zip |
-
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.0.16-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.0.16-<os>-<arch>/
-
Start the product
Start the product using the following command:
If you are using a Linux or macOS machine:
bash start.sh
If you are using a Windows machine:
.\start.ps1
Option 2: Run with Docker
Follow these steps to run WSO2 Thunder using Docker.
-
Pull the Docker image
docker pull ghcr.io/asgardeo/thunder:0.0.16
-
Run the container
docker run --rm \ -p 8090:8090 \ -p 9090:9090 \ ghcr.io/asgardeo/thunder:0.0.16
Optionally if you want to modify the server configurations, you can mount a custom
deployment.yamlfile. Create adeployment.yamlfile 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.0.16Optionally 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.0.16
Try Out the Product
Try Out with the Sample App
To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.
Download and Run the Sample App
- Download the sample app from the 0.0.16 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | sample-app-0.0.16-macos-arm64.zip |
| macOS | x64 (Intel) | sample-app-0.0.16-macos-x64.zip |
| Linux | x64 | sample-app-0.0.16-linux-x64.zip |
| Linux | ARM64 | sample-app-0.0.16-linux-arm64.zip |
| Windows | x64 | sample-app-0.0.16-win-x64.zip |
-
Unzip and navigate to the sample app directory
unzip sample-app-0.0.16-<os>-<arch>.zip cd sample-app-0.0.16-<os>-<arch>/
-
Create required application for sample app in Thunder
Before using the sample app, you need to create an application in Thunder:
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Sample App", "description": "Sample application for testing", "url": "https://localhost:3000", "logo_url": "https://localhost:3000/logo.png", "auth_flow_graph_id": "auth_flow_config_basic", "registration_flow_graph_id": "registration_flow_config_basic", "is_registration_flow_enabled": true, "inbound_auth_config": [{ "type": "oauth2", "config": { "client_id": "sample_app_client", "client_secret": "sample_app_secret", "redirect_uris": ["https://localhost:3000"], "grant_types": ["authorization_code", "client_credentials"], "response_types": ["code"], "token_endpoint_auth_methods": ["client_secret_basic", "client_secret_post"], "pkce_required": false, "public_client": false } }] }'
Note the
idfrom the response - you'll need it for the sample app configuration. -
Configure the sample app
Open the
runtime.jsonfile in the thunder-sample-app-0.0.16--/app directory and update the configurations:applicationID: Use the application ID from step 3flowEndpoint: The root endpoint for the flow execution API (default:https://localhost:8090/flow)
-
Start the sample app
sh start.sh
Open your browser and navigate to https://localhost:3000 to see the sample app in action.
Self Register a User
To self register a user in the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.
-
Provide a username and password for the new user and click on the "Create Account" button.
-
Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.
-
After successful registration, you will be automatically logged in to the sample application.
Login to the Sample App
To log in to the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000.
-
Enter username and password you used during the self registration process and click on the "Sign In" button.
-
If the login is successful, you will be redirected to the home page of the sample app with the access token.
Try Out Client Credentials Flow
The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.
To try out the Client Credentials flow, follow these steps:
-
Create a Client Application
Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Test Sample App", "description": "Initial testing App", "auth_flow_graph_id": "auth_flow_config_basic", "inbound_auth_config": [ { "type": "oauth2", "config": { "client_id": "<client_id>", "client_secret": "<client_secret>", "redirect_uris": [ "https://localhost:3000" ], "grant_types": [ "client_credentials" ]...
Thunder v0.0.15
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
- No significant changes.
⚡ 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.0.15 release of WSO2 Thunder and run it locally.
- Download the distribution from the 0.0.15 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | thunder-0.0.15-macos-arm64.zip |
| macOS | x64 (Intel) | thunder-0.0.15-macos-x64.zip |
| Linux | x64 | thunder-0.0.15-linux-x64.zip |
| Linux | ARM64 | thunder-0.0.15-linux-arm64.zip |
| Windows | x64 | thunder-0.0.15-win-x64.zip |
-
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.0.15-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.0.15-<os>-<arch>/
-
Start the product
Start the product using the following command:
If you are using a Linux or macOS machine:
bash start.sh
If you are using a Windows machine:
.\start.ps1
Option 2: Run with Docker
Follow these steps to run WSO2 Thunder using Docker.
-
Pull the Docker image
docker pull ghcr.io/asgardeo/thunder:0.0.15
-
Run the container
docker run --rm \ -p 8090:8090 \ -p 9090:9090 \ ghcr.io/asgardeo/thunder:0.0.15
Optionally if you want to modify the server configurations, you can mount a custom
deployment.yamlfile. Create adeployment.yamlfile 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.0.15Optionally 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.0.15
Try Out the Product
Try Out with the Sample App
To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.
Download and Run the Sample App
- Download the sample app from the 0.0.15 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | sample-app-0.0.15-macos-arm64.zip |
| macOS | x64 (Intel) | sample-app-0.0.15-macos-x64.zip |
| Linux | x64 | sample-app-0.0.15-linux-x64.zip |
| Linux | ARM64 | sample-app-0.0.15-linux-arm64.zip |
| Windows | x64 | sample-app-0.0.15-win-x64.zip |
-
Unzip and navigate to the sample app directory
unzip sample-app-0.0.15-<os>-<arch>.zip cd sample-app-0.0.15-<os>-<arch>/
-
Create required application for sample app in Thunder
Before using the sample app, you need to create an application in Thunder:
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Sample App", "description": "Sample application for testing", "url": "https://localhost:3000", "logo_url": "https://localhost:3000/logo.png", "auth_flow_graph_id": "auth_flow_config_basic", "registration_flow_graph_id": "registration_flow_config_basic", "is_registration_flow_enabled": true, "inbound_auth_config": [{ "type": "oauth2", "config": { "client_id": "sample_app_client", "client_secret": "sample_app_secret", "redirect_uris": ["https://localhost:3000"], "grant_types": ["authorization_code", "client_credentials"], "response_types": ["code"], "token_endpoint_auth_methods": ["client_secret_basic", "client_secret_post"], "pkce_required": false, "public_client": false } }] }'
Note the
idfrom the response - you'll need it for the sample app configuration. -
Configure the sample app
Open the
runtime.jsonfile in the thunder-sample-app-0.0.15--/app directory and update the configurations:applicationID: Use the application ID from step 3flowEndpoint: The root endpoint for the flow execution API (default:https://localhost:8090/flow)
-
Start the sample app
sh start.sh
Open your browser and navigate to https://localhost:3000 to see the sample app in action.
Self Register a User
To self register a user in the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.
-
Provide a username and password for the new user and click on the "Create Account" button.
-
Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.
-
After successful registration, you will be automatically logged in to the sample application.
Login to the Sample App
To log in to the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000.
-
Enter username and password you used during the self registration process and click on the "Sign In" button.
-
If the login is successful, you will be redirected to the home page of the sample app with the access token.
Try Out Client Credentials Flow
The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.
To try out the Client Credentials flow, follow these steps:
-
Create a Client Application
Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Test Sample App", "description": "Initial testing App", "auth_flow_graph_id": "auth_flow_config_basic", "inbound_auth_config": [ { "type": "oauth2", "config": { "client_id": "<client_id>", "client_secret": "<client_secret>", "redirect_uris": [ "https://localhost:3000" ], "grant_types": [ "client_credentials" ], ...
Thunder v0.0.14
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
⚡ 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.0.14 release of WSO2 Thunder and run it locally.
- Download the distribution from the 0.0.14 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | thunder-0.0.14-macos-arm64.zip |
| macOS | x64 (Intel) | thunder-0.0.14-macos-x64.zip |
| Linux | x64 | thunder-0.0.14-linux-x64.zip |
| Linux | ARM64 | thunder-0.0.14-linux-arm64.zip |
| Windows | x64 | thunder-0.0.14-win-x64.zip |
-
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.0.14-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.0.14-<os>-<arch>/
-
Start the product
Start the product using the following command:
If you are using a Linux or macOS machine:
bash start.sh
If you are using a Windows machine:
.\start.ps1
Option 2: Run with Docker
Follow these steps to run WSO2 Thunder using Docker.
-
Pull the Docker image
docker pull ghcr.io/asgardeo/thunder:0.0.14
-
Run the container
docker run --rm \ -p 8090:8090 \ -p 9090:9090 \ ghcr.io/asgardeo/thunder:0.0.14
Optionally if you want to modify the server configurations, you can mount a custom
deployment.yamlfile. Create adeployment.yamlfile 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.0.14Optionally 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.0.14
Try Out the Product
Try Out with the Sample App
To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.
Download and Run the Sample App
- Download the sample app from the 0.0.14 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | sample-app-0.0.14-macos-arm64.zip |
| macOS | x64 (Intel) | sample-app-0.0.14-macos-x64.zip |
| Linux | x64 | sample-app-0.0.14-linux-x64.zip |
| Linux | ARM64 | sample-app-0.0.14-linux-arm64.zip |
| Windows | x64 | sample-app-0.0.14-win-x64.zip |
-
Unzip and navigate to the sample app directory
unzip sample-app-0.0.14-<os>-<arch>.zip cd sample-app-0.0.14-<os>-<arch>/
-
Create required application for sample app in Thunder
Before using the sample app, you need to create an application in Thunder:
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Sample App", "description": "Sample application for testing", "url": "https://localhost:3000", "logo_url": "https://localhost:3000/logo.png", "auth_flow_graph_id": "auth_flow_config_basic", "registration_flow_graph_id": "registration_flow_config_basic", "is_registration_flow_enabled": true, "inbound_auth_config": [{ "type": "oauth2", "config": { "client_id": "sample_app_client", "client_secret": "sample_app_secret", "redirect_uris": ["https://localhost:3000"], "grant_types": ["authorization_code", "client_credentials"], "response_types": ["code"], "token_endpoint_auth_methods": ["client_secret_basic", "client_secret_post"], "pkce_required": false, "public_client": false } }] }'
Note the
idfrom the response - you'll need it for the sample app configuration. -
Configure the sample app
Open the
runtime.jsonfile in the thunder-sample-app-0.0.14--/app directory and update the configurations:applicationID: Use the application ID from step 3flowEndpoint: The root endpoint for the flow execution API (default:https://localhost:8090/flow)
-
Start the sample app
sh start.sh
Open your browser and navigate to https://localhost:3000 to see the sample app in action.
Self Register a User
To self register a user in the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.
-
Provide a username and password for the new user and click on the "Create Account" button.
-
Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.
-
After successful registration, you will be automatically logged in to the sample application.
Login to the Sample App
To log in to the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000.
-
Enter username and password you used during the self registration process and click on the "Sign In" button.
-
If the login is successful, you will be redirected to the home page of the sample app with the access token.
Try Out Client Credentials Flow
The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.
To try out the Client Credentials flow, follow these steps:
-
Create a Client Application
Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Test Sample App", "description": "Initial testing App", "auth_flow_graph_id": "auth_flow_config_basic", "inbound_auth_config": [ { "type": "oauth2", "config": { "client_id": "<client_id>", "client_secret": "<client_secret>", "redirect_uris": [ "https://localhost:3000" ], "grant_types": [ "client_credentials" ], "token_endpoint_aut...
Thunder v0.0.13
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
- No significant changes.
⚡ 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.0.13 release of WSO2 Thunder and run it locally.
- Download the distribution from the 0.0.13 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | thunder-0.0.13-macos-arm64.zip |
| macOS | x64 (Intel) | thunder-0.0.13-macos-x64.zip |
| Linux | x64 | thunder-0.0.13-linux-x64.zip |
| Linux | ARM64 | thunder-0.0.13-linux-arm64.zip |
| Windows | x64 | thunder-0.0.13-win-x64.zip |
-
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.0.13-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.0.13-<os>-<arch>/
-
Start the product
Start the product using the following command:
If you are using a Linux or macOS machine:
bash start.sh
If you are using a Windows machine:
.\start.ps1
Option 2: Run with Docker
Follow these steps to run WSO2 Thunder using Docker.
-
Pull the Docker image
docker pull ghcr.io/asgardeo/thunder:0.0.13
-
Run the container
docker run --rm \ -p 8090:8090 \ -p 9090:9090 \ ghcr.io/asgardeo/thunder:0.0.13
Optionally if you want to modify the server configurations, you can mount a custom
deployment.yamlfile. Create adeployment.yamlfile 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.0.13Optionally 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.0.13
Try Out the Product
Try Out with the Sample App
To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.
Download and Run the Sample App
- Download the sample app from the 0.0.13 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | sample-app-0.0.13-macos-arm64.zip |
| macOS | x64 (Intel) | sample-app-0.0.13-macos-x64.zip |
| Linux | x64 | sample-app-0.0.13-linux-x64.zip |
| Linux | ARM64 | sample-app-0.0.13-linux-arm64.zip |
| Windows | x64 | sample-app-0.0.13-win-x64.zip |
-
Unzip and navigate to the sample app directory
unzip sample-app-0.0.13-<os>-<arch>.zip cd sample-app-0.0.13-<os>-<arch>/
-
Create required application for sample app in Thunder
Before using the sample app, you need to create an application in Thunder:
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Sample App", "description": "Sample application for testing", "url": "https://localhost:3000", "logo_url": "https://localhost:3000/logo.png", "auth_flow_graph_id": "auth_flow_config_basic", "registration_flow_graph_id": "registration_flow_config_basic", "is_registration_flow_enabled": true, "inbound_auth_config": [{ "type": "oauth2", "config": { "client_id": "sample_app_client", "client_secret": "sample_app_secret", "redirect_uris": ["https://localhost:3000"], "grant_types": ["authorization_code", "client_credentials"], "response_types": ["code"], "token_endpoint_auth_methods": ["client_secret_basic", "client_secret_post"], "pkce_required": false, "public_client": false } }] }'
Note the
idfrom the response - you'll need it for the sample app configuration. -
Configure the sample app
Open the
runtime.jsonfile in the thunder-sample-app-0.0.13--/app directory and update the configurations:applicationID: Use the application ID from step 3flowEndpoint: The root endpoint for the flow execution API (default:https://localhost:8090/flow)
-
Start the sample app
sh start.sh
Open your browser and navigate to https://localhost:3000 to see the sample app in action.
Self Register a User
To self register a user in the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.
-
Provide a username and password for the new user and click on the "Create Account" button.
-
Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.
-
After successful registration, you will be automatically logged in to the sample application.
Login to the Sample App
To log in to the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000.
-
Enter username and password you used during the self registration process and click on the "Sign In" button.
-
If the login is successful, you will be redirected to the home page of the sample app with the access token.
Try Out Client Credentials Flow
The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.
To try out the Client Credentials flow, follow these steps:
-
Create a Client Application
Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Test Sample App", "description": "Initial testing App", "auth_flow_graph_id": "auth_flow_config_basic", "inbound_auth_config": [ { "type": "oauth2", "config": { "client_id": "<client_id>", "client_secret": "<client_secret>", "redirect_uris": [ "https://localhost:3000" ], "grant_types": [ "client_credentials" ], ...
Thunder v0.0.12
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
- No significant changes.
⚡ 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.0.12 release of WSO2 Thunder and run it locally.
- Download the distribution from the 0.0.12 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | thunder-0.0.12-macos-arm64.zip |
| macOS | x64 (Intel) | thunder-0.0.12-macos-x64.zip |
| Linux | x64 | thunder-0.0.12-linux-x64.zip |
| Linux | ARM64 | thunder-0.0.12-linux-arm64.zip |
| Windows | x64 | thunder-0.0.12-win-x64.zip |
-
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.0.12-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.0.12-<os>-<arch>/
-
Start the product
Start the product using the following command:
If you are using a Linux or macOS machine:
bash start.sh
If you are using a Windows machine:
.\start.ps1
Option 2: Run with Docker
Follow these steps to run WSO2 Thunder using Docker.
-
Pull the Docker image
docker pull ghcr.io/asgardeo/thunder:0.0.12
-
Run the container
docker run --rm \ -p 8090:8090 \ ghcr.io/asgardeo/thunder:0.0.12
Optionally if you want to modify the server configurations, you can mount a custom
deployment.yamlfile. Create adeployment.yamlfile 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.0.12Optionally 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.0.12
Try Out the Product
Try Out with the Sample App
To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.
Download and Run the Sample App
- Download the sample app from the 0.0.12 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | sample-app-0.0.12-macos-arm64.zip |
| macOS | x64 (Intel) | sample-app-0.0.12-macos-x64.zip |
| Linux | x64 | sample-app-0.0.12-linux-x64.zip |
| Linux | ARM64 | sample-app-0.0.12-linux-arm64.zip |
| Windows | x64 | sample-app-0.0.12-win-x64.zip |
-
Unzip and navigate to the sample app directory
unzip sample-app-0.0.12-<os>-<arch>.zip cd sample-app-0.0.12-<os>-<arch>/
-
Create required application for sample app in Thunder
Before using the sample app, you need to create an application in Thunder:
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Sample App", "description": "Sample application for testing", "url": "https://localhost:3000", "logo_url": "https://localhost:3000/logo.png", "auth_flow_graph_id": "auth_flow_config_basic", "registration_flow_graph_id": "registration_flow_config_basic", "is_registration_flow_enabled": true, "inbound_auth_config": [{ "type": "oauth2", "config": { "client_id": "sample_app_client", "client_secret": "sample_app_secret", "redirect_uris": ["https://localhost:3000"], "grant_types": ["authorization_code", "client_credentials"], "response_types": ["code"], "token_endpoint_auth_methods": ["client_secret_basic", "client_secret_post"], "pkce_required": false, "public_client": false } }] }'
Note the
idfrom the response - you'll need it for the sample app configuration. -
Configure the sample app
Open the
runtime.jsonfile in the thunder-sample-app-0.0.12--/app directory and update the configurations:applicationID: Use the application ID from step 3flowEndpoint: The root endpoint for the flow execution API (default:https://localhost:8090/flow)
-
Start the sample app
sh start.sh
Open your browser and navigate to https://localhost:3000 to see the sample app in action.
Self Register a User
To self register a user in the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.
-
Provide a username and password for the new user and click on the "Create Account" button.
-
Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.
-
After successful registration, you will be automatically logged in to the sample application.
Login to the Sample App
To log in to the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000.
-
Enter username and password you used during the self registration process and click on the "Sign In" button.
-
If the login is successful, you will be redirected to the home page of the sample app with the access token.
Try Out Client Credentials Flow
The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.
To try out the Client Credentials flow, follow these steps:
-
Create a Client Application
Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Test Sample App", "description": "Initial testing App", "auth_flow_graph_id": "auth_flow_config_basic", "inbound_auth_config": [ { "type": "oauth2", "config": { "client_id": "<client_id>", "client_secret": "<client_secret>", "redirect_uris": [ "https://localhost:3000" ], "grant_types": [ "client_credentials" ], "token_endpoint...
Thunder v0.0.11
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
- No significant changes.
⚡ 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.0.11 release of WSO2 Thunder and run it locally.
- Download the distribution from the 0.0.11 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | thunder-0.0.11-macos-arm64.zip |
| macOS | x64 (Intel) | thunder-0.0.11-macos-x64.zip |
| Linux | x64 | thunder-0.0.11-linux-x64.zip |
| Linux | ARM64 | thunder-0.0.11-linux-arm64.zip |
| Windows | x64 | thunder-0.0.11-win-x64.zip |
-
Unzip the product
Unzip the downloaded file using the following command:
unzip thunder-0.0.11-<os>-<arch>.zip
Navigate to the unzipped directory:
cd thunder-0.0.11-<os>-<arch>/
-
Start the product
Start the product using the following command:
If you are using a Linux or macOS machine:
bash start.sh
If you are using a Windows machine:
.\start.ps1
Option 2: Run with Docker
Follow these steps to run WSO2 Thunder using Docker.
-
Pull the Docker image
docker pull ghcr.io/asgardeo/thunder:0.0.11
-
Run the container
docker run --rm \ -p 8090:8090 \ ghcr.io/asgardeo/thunder:0.0.11
Optionally if you want to modify the server configurations, you can mount a custom
deployment.yamlfile. Create adeployment.yamlfile 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.0.11Optionally 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.0.11
Try Out the Product
Try Out with the Sample App
To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.
Download and Run the Sample App
- Download the sample app from the 0.0.11 release
| OS | Architecture | Download Link |
|---|---|---|
| macOS | ARM64 (Apple Silicon) | sample-app-0.0.11-macos-arm64.zip |
| macOS | x64 (Intel) | sample-app-0.0.11-macos-x64.zip |
| Linux | x64 | sample-app-0.0.11-linux-x64.zip |
| Linux | ARM64 | sample-app-0.0.11-linux-arm64.zip |
| Windows | x64 | sample-app-0.0.11-win-x64.zip |
-
Unzip and navigate to the sample app directory
unzip sample-app-0.0.11-<os>-<arch>.zip cd sample-app-0.0.11-<os>-<arch>/
-
Create required application for sample app in Thunder
Before using the sample app, you need to create an application in Thunder:
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Sample App", "description": "Sample application for testing", "url": "https://localhost:3000", "logo_url": "https://localhost:3000/logo.png", "auth_flow_graph_id": "auth_flow_config_basic", "registration_flow_graph_id": "registration_flow_config_basic", "is_registration_flow_enabled": true, "inbound_auth_config": [{ "type": "oauth2", "config": { "client_id": "sample_app_client", "client_secret": "sample_app_secret", "redirect_uris": ["https://localhost:3000"], "grant_types": ["authorization_code", "client_credentials"], "response_types": ["code"], "token_endpoint_auth_methods": ["client_secret_basic", "client_secret_post"], "pkce_required": false, "public_client": false } }] }'
Note the
idfrom the response - you'll need it for the sample app configuration. -
Configure the sample app
Open the
runtime.jsonfile in the thunder-sample-app-0.0.11--/app directory and update the configurations:applicationID: Use the application ID from step 3flowEndpoint: The root endpoint for the flow execution API (default:https://localhost:8090/flow)
-
Start the sample app
sh start.sh
Open your browser and navigate to https://localhost:3000 to see the sample app in action.
Self Register a User
To self register a user in the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.
-
Provide a username and password for the new user and click on the "Create Account" button.
-
Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.
-
After successful registration, you will be automatically logged in to the sample application.
Login to the Sample App
To log in to the sample app, follow these steps:
-
Open the sample app in your browser at https://localhost:3000.
-
Enter username and password you used during the self registration process and click on the "Sign In" button.
-
If the login is successful, you will be redirected to the home page of the sample app with the access token.
Try Out Client Credentials Flow
The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.
To try out the Client Credentials flow, follow these steps:
-
Create a Client Application
Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.
curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \ -d '{ "name": "Test Sample App", "description": "Initial testing App", "auth_flow_graph_id": "auth_flow_config_basic", "inbound_auth_config": [ { "type": "oauth2", "config": { "client_id": "<client_id>", "client_secret": "<client_secret>", "redirect_uris": [ "https://localhost:3000" ], "grant_types": [ "client_credentials" ], "token_endpoint_auth_methods": [ "client_secret_basic", "client_secret_post" ], ...

























