2017-03-15 12:26:46 +00:00
Keycloak Documentation
======================
Open Source Identity and Access Management for modern Applications and Services.
2021-12-16 15:36:14 +00:00
For more information about Keycloak visit the [Keycloak homepage ](http://keycloak.org ) and [Keycloak blog ](https://www.keycloak.org/blog ).
2017-03-15 12:26:46 +00:00
2017-11-15 13:44:10 +00:00
Contributing to Keycloak Documentation
2021-11-04 16:52:58 +00:00
----------------------------------------
2017-11-15 13:44:10 +00:00
See our [Contributor's Guide ](internal_resources/contributing.adoc ). The directory also includes a set of templates and other resources to help you get started.
2019-12-18 07:44:40 +00:00
If you want to file a bug report or tell us about any other issue with this documentation, you are invited to please use our [issue tracker ](https://issues.redhat.com/projects/KEYCLOAK/ ).
2018-02-09 19:08:33 +00:00
2017-11-15 13:44:10 +00:00
2017-03-15 12:26:46 +00:00
Building Keycloak Documentation
2021-11-05 11:17:56 +00:00
---------------------------------
2017-03-15 12:26:46 +00:00
2017-09-05 11:13:44 +00:00
Ensure that you have [Maven installed ](https://maven.apache.org/ ).
2017-03-15 12:26:46 +00:00
2017-09-05 13:10:34 +00:00
First, clone the Keycloak Documentation repository:
2017-09-05 11:13:44 +00:00
2017-03-15 12:26:46 +00:00
git clone https://github.com/keycloak/keycloak-documentation.git
cd keycloak-documentation
2017-09-05 11:13:44 +00:00
2019-04-25 11:56:21 +00:00
If you are using Windows, you need to run the following command with administrator privilege because this project uses symbolic links:
git clone -c core.symlinks=true https://github.com/keycloak/keycloak-documentation.git
2017-03-15 12:26:46 +00:00
To build Keycloak Documentation run:
2017-08-28 18:13:48 +00:00
mvn clean install
2017-08-29 07:33:20 +00:00
Or to build a specific guide run:
mvn clean install -f GUIDE_DIR
2019-11-06 09:57:00 +00:00
2020-07-21 16:03:07 +00:00
By default, an archive version of the documentation is built. To build the latest build run:
2019-11-06 09:57:00 +00:00
mvn clean install -Dlatest
2017-09-05 11:13:44 +00:00
2019-04-12 07:22:10 +00:00
You can then view the documentation by opening GUIDE_DIR/target/generated-docs/index.html.
2017-03-15 12:26:46 +00:00
License
-------
* [Apache License, Version 2.0 ](https://www.apache.org/licenses/LICENSE-2.0 )
