teamhanko /hanko
Modern authentication, on your terms. Open source alternative to Auth0, Clerk, WorkOS, Stytch.
★ 9,072⑂ 1,024👁 36⑃ 2,650● 441▤ 44
+0
日增长
9,072
stars
1,024
forks
36
watchers
2,650
prs
441
issues
44
releases
README
---
About Hanko
Hanko is an open source authentication and user management solution that is easy to integrate, framework-agnostic, and built on privacy-first principles like data minimalism and phishing resistance.
- Supports all modern authentication methods: passwords, MFA, passkeys, social logins, and SAML SSO
- Flexible configuration options, including passkey-only, OAuth-only, and user-deletable passwords
- Easy integration with Hanko Elements web components
- A robust API that handles all authentication and onboarding flow states, enabling fast, reliable custom frontend implementations
- API-first, lightweight, cloud-native
Available for self-hosting and as a fully managed service on Hanko Cloud.
Features
To follow the development of this project, watch our releases, leave a star, sign up to our Product News or join our Discord Community. Here's a brief overview of Hanko's current and upcoming features:
| Status | Feature |
|:------:| :--- |
|✅| Email / username identifiers |
|✅| Passwords, passcodes, passkeys |
|✅| Hanko Elements web components |
|✅| OAuth SSO (Sign in with Apple/Google/GitHub and more) |
|✅| i18n & custom translations |
|✅| SAML Enterprise SSO |
|✅| Webhooks |
|✅| Server-side sessions & remote session revocation |
|✅| MFA (TOTP, security keys) |
|✅| Custom OIDC/OAuth connections |
|✅| JS SDK |
|⚙️| Organizations, Roles, Permissions |
| | web component |
| | iOS, Android, React Native, Flutter SDKs |
Visit our Roadmap for more information on upcoming features.
Contact us
Schedule a demo with the team. Learn how you can built state-of-the-art authentication for your apps effortlessly with Hanko.
Architecture
The main building blocks of the Hanko project are
- backend - Scalable, robust, and lightweight authentication API for passwords, passkeys, email passcodes, OAuth SSO, user and session management, and JWT issuing
- hanko-elements - Web components made for the Hanko API that provide onboarding, login, and user profile functionality and are customizable with CSS
- hanko-frontend-sdk - A client package for using the Hanko API
The remainder of the repository consists of:
- quickstart - A quickstart example app showing off Hanko's login experience and acting as a reference implementation
- examples - Example implementations for a number of frameworks
- docs - The Hanko documentation (docs.hanko.io) - Moved to its own repo here: https://github.com/teamhanko/docs
Getting started
1. Try our hosted live example and our companion page passkeys.io or use the quickstart app to get a feel for the user experience provided by an application that leverages the Hanko backend API and our custom web component
2. To run the project locally, there are two options available:
- Bare metal:
- Head over to the backend section to learn how to get it up and running for your own project. Use Hanko Cloud for a hosted backend.
- Docker:
- If you prefer to use Docker to run the project locally, please visit thTop issues
#1462Add CSS shadow parts to the accordion10 comments · 2024-05-15#2338500 response during social login (google)8 comments · 2025-12-12#1104Improve layout shift on load7 comments · 2023-10-18#691Custom fields / user data6 comments · 2023-03-22#1806Add devcontainers for easy Codespace setup4 comments · 2024-10-18#1134NextJS build failed because of `ReferenceError: CustomEvent is not defined`5 comments · 2023-10-25#177SMS code support5 comments · 2022-08-11#2472500 on login when account is not registered4 comments · 2026-03-04
Discussions
#2572Task-based evaluation for LLM usage of Hanko SDK0 comments · 2026-03-30#2410Import users0 comments · 2026-02-09#2384Hanko 2.40 comments · 2026-01-20#2296API Documentation0 comments · 2025-11-09#2286Passwordless0 comments · 2025-10-26#2251Failed to execute before state hook (state: passcode_confirmation)2 comments · 2025-09-19#2240Support atproto-oauth login (Bluesky)0 comments · 2025-09-03#2179How do I delete my own account?1 comments · 2025-06-29
Latest release
Hanko v3.1 backend/v3.1.0 2026-10-01Hanko v3.1 introduces Organizations and Roles for building B2B applications, alongside Custom Claims and Mapping for bringing identity provider attributes into your application. This release also adds session lifecycle webhooks, improves user imports, and includes several security fixes. Organizations and Roles You can now group users into organizations within a Hanko tenant and assign roles to their memberships. This gives applications a foundation for managing customer accounts, teams, and organization-specific access. Roles are defined at the tenant level and assigned to users wit