diff --git a/docbook/reference/en/en-US/modules/server-installation.xml b/docbook/reference/en/en-US/modules/server-installation.xml index 9667a7b79c..223c3303d8 100755 --- a/docbook/reference/en/en-US/modules/server-installation.xml +++ b/docbook/reference/en/en-US/modules/server-installation.xml @@ -826,4 +826,36 @@ All configuration options are optional. Default value for directory is Themes sections for more information on how to do this. + +
+ Installing Keycloak Server as Root Context + + The Keycloak server can be installed as the default web application. This way, instead of referencing + the server as http://mydomain.com/auth, it would be + http://mydomain.com/. + + + To do this, you need to add a default-web-module attribute in the Undertow subystem in standalone.xml. + + + + + +]]> + + + main-auth-server is the name of the Keycloak server as defined in the Keycloak subsystem. + + + + If you have already run your server before changing to the root context then your database + will contain references to the old /auth context. And, your clients may also have incorrect + references. To fix this on the server side, you will need to export + your database to json, make corrections, and then import. Client-side keycloak.json + files will need to be updated manually as well. + + + +