2017-03-15 12:26:46 +00:00
Keycloak Documentation
======================
Open Source Identity and Access Management for modern Applications and Services.
2018-02-09 19:08:33 +00:00
For more information about Keycloak visit the [Keycloak homepage ](http://keycloak.org ) and [Keycloak blog ](http://blog.keycloak.org ).
2017-03-15 12:26:46 +00:00
2017-11-15 13:44:10 +00:00
Contributing to Keycloak Documentation
--------------------------------------
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.
2018-02-09 19:08:33 +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.jboss.org/projects/KEYCLOAK/ ).
2017-11-15 13:44:10 +00:00
2017-03-15 12:26:46 +00:00
Building Keycloak Documentation
-------------------------------
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
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
2017-09-05 11:13:44 +00:00
2017-08-29 07:33:20 +00:00
You can then view the documentation by opening GUIDE_DIR/target/frames.html or GUIDE_DIR/target/index.html.
2017-03-15 12:26:46 +00:00
Building RH-SSO Documentation
-----------------------------
Keycloak is the basis of [Red Hat Single Sign-On ](https://access.redhat.com/products/red-hat-single-sign-on ). The same documentation sources are used, but they are built slighty differently.
2017-08-28 12:50:14 +00:00
To build the documentation for RH-SSO run:
2017-04-07 08:05:47 +00:00
2017-08-28 18:13:48 +00:00
mvn clean install -Dproduct
2017-03-15 12:26:46 +00:00
2017-08-29 07:33:20 +00:00
Or to build a specific guide run:
mvn clean install -Dproduct -f GUIDE_DIR
You can then view the documentation by opening GUIDE_DIR/target/frames.html or GUIDE_DIR/target/index.html.
If you have ccutil installed you can build the guides with:
./build-product.sh
Or individual guides with:
2017-03-15 12:26:46 +00:00
2017-08-29 07:33:20 +00:00
./build-product.sh GUIDE_DIR
2017-03-15 12:26:46 +00:00
License
-------
* [Apache License, Version 2.0 ](https://www.apache.org/licenses/LICENSE-2.0 )