AuthKit-Pro quickstart

Prerequisites

The Maven wrapper is included. A system Maven installation, MySQL, SMTP server, Docker, and Redis are not required for the first run.

• A purchased and extracted AuthKit-Pro ZIP
• Java 25
• A current browser

Run the project

After purchasing, downloading, and extracting the Gumroad ZIP, enter the project directory and run the wrapper.

cd AuthKit-Pro
./mvnw spring-boot:run

Set-Location .\AuthKit-Pro
.\mvnw.cmd spring-boot:run

Runnable local defaults

Register the first user

A fresh database has no users. Register through the browser API tester or send the public registration request. The response is intentionally generic whether registration succeeds or an account already exists.

{
  "username": "developer",
  "email": "developer@example.com",
  "password": "choose-at-least-12-characters"
}

Open the browser API tester

Open http://localhost:8080/api-test. The same-origin tester covers the available account, session, provider, magic-link, and passkey flows without bypassing their authentication or CSRF requirements.

• Register and sign in with the account you created.
• Keep returned access and refresh credentials in the tester's in-memory state.
• Call protected endpoints with their normal Bearer JWT rules.
• Enable optional browser authentication features only after the core flow works.

Optional demo data

For local development on an empty database, set AUTHKIT_DEMO_DATA_ENABLED=true before startup to seed user and admin, both with password password123123. Demo data is opt-in and local-only.

Run verification

./mvnw test
./mvnw clean verify

.\mvnw.cmd test
.\mvnw.cmd clean verify

✓ AuthKit-Pro is running with H2, registration and login are available, and the local verification suite passes.

Configure for further development

Copy .env.example to the ignored .env file only when you need stable secrets, persistent MySQL data, mail, external providers, passkeys, magic links, or other overrides.