Get ThunderID

ThunderID is available in multiple formats to suit your deployment needs. Choose the option that works best for you.

📦 Release Artifact

Download From Release

Get the latest release of ThunderID and run it locally on your machine.

Prerequisites

• Your operating system and architecture (macOS, Linux, or Windows)
• Terminal or command prompt access

Step 1: Download the Distribution

Download thunderid-<version>-<os>-<arch>.zip from the latest release for your operating system and architecture.

Example

If you're using a MacOS machine with Apple Silicon (ARM64) processor, download thunderid-<version>-macos-arm64.zip

Step 2: Extract the Archive

Unzip the downloaded file:

unzip thunderid-<version>-<os>-<arch>.zip

Navigate to the extracted directory:

cd thunderid-<version>-<os>-<arch>/

Step 3: Setup ThunderID

Initialize ThunderID with the default configurations and data before starting the server for the first time.

Linux / macOS

./setup.sh

Windows

.\setup.ps1

Important

Note the sample app ID from the log line: [INFO] Sample App ID: <id>. You'll need this for configuring the sample application.

Step 4: Start ThunderID

Launch the ThunderID server:

Linux / macOS

./start.sh

Windows

.\start.ps1

Success

ThunderID will start on https://localhost:8090

🐳 Docker Compose

Run with Docker Compose

The quickest way to get ThunderID up and running with all dependencies configured.

Prerequisites

• Docker and Docker Compose installed on your machine
• Terminal or command prompt access

Step 1: Download Docker Compose File

Download the docker-compose.yml file from the ThunderID repository:

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

Step 2: Start ThunderID

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

docker compose up

note

This command will automatically:

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

Important

Note the sample app ID from the setup logs: [INFO] Sample App ID: <id>. You'll need this for configuring the sample application.

Success

ThunderID will start on https://localhost:8090

Next Steps

Now that ThunderID is running, you can:

• Access the ThunderID Console - Log in with the default admin credentials (admin / admin)
• Try the Sample Apps - Test ThunderID's authentication flows with our pre-built React samples
• Explore the APIs - Learn about ThunderID's RESTful APIs for user management, authentication, and more

Need Help?

Check out our troubleshooting guide or join our community.