Keycloak aims to be easy to use and lightweight. The project was founded to make it easy for application developers to secure modern applications and services.
The 80/20 rule, that states 80% of requirements come from around 20% of use cases, is a core part of the vision behind Keycloak. We strongly believe if Keycloak would support all use cases by default it would become bloated and hard to use.
Keycloak aims to be opinionated and make it as easy as possible to achieve the common use cases, while still enabling the less common use cases through custom extensions.
Keycloak consists of several projects:
- Keycloak - Keycloak Server and Java adapters
- Keycloak QuickStarts - QuickStarts for getting started with Keycloak
- Keycloak Benchmark - Load tests for benchmarking Keycloak
- Keycloak Community - Keycloak design documents
- Keycloak Web - Website keycloak.org
The same governance model applies to all projects. However, the list of maintainers may vary per project.
The list of maintainers can be found in the MAINTAINERS.md file in the repository for the individual projects listed in the Projects section.
A maintainer is someone who has shown deep knowledge of vision, features and codebase. It is their responsibility to drive the project forward, encourage collaboration and contributions, and generally help the community.
Responsibilities of a maintainer include, but are not limited to:
- Engage in design discussions
- Actively monitor mailing lists, user forum and chat
- Contribute high quality code
- Maintain deep knowledge of vision, features and codebase
- Review pull requests either personally or delegate to experts in the relevant area
- Helping the community
To become a maintainer, you need to demonstrate the following:
- Good understanding of vision, features and codebase
- Contribution of larger features
- Contribution of bug fixes
- Participation in design discussions
- Participation in pull request reviews
- Ability to collaborate with the team
- Helping the community
A new maintainer must be proposed by sending an email to keycloak-maintainers(at)googlegroups.com. The email should include evidence of the above list.
The existing maintainers will then discuss the proposal. If anyone objects or wants more information, the maintainers will reach out to the nominee directly for further discussion.
For the nominee to be accepted as a maintainer at least 2/3 of existing maintainers have to approve the nominee.
Every 6 months (March and September) active maintainers fill in a survey covering what they have been doing as a maintainer for the last period, and what they are planning on focusing on in the next period. The survey is not made publicly available, but is shared with existing maintainers. This serves two purposes; firstly for the maintainers group to better understand what each maintainer is focusing on, and secondly to identify maintainers that are no longer active.
In the majority of cases a maintainer is removed by the maintainer stepping down themselves (by sending an email to keycloak-maintainers(at)googlegroups.com). However, in exceptional circumstances a maintainer can also be removed with 2/3 of votes from existing maintainers.
The process of reviewing proposed changes differs depending of the size and impact of the change.