From ec018d27399a292b352aed6e828b33029e65b417 Mon Sep 17 00:00:00 2001 From: Eugene Chow Date: Tue, 29 Sep 2015 10:32:16 +0800 Subject: [PATCH] Updated documentation for "Server Installation > Installing Keycloak Server as Root Context" to work with Keycloak 1.5 --- .../en/en-US/modules/server-installation.xml | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/docbook/reference/en/en-US/modules/server-installation.xml b/docbook/reference/en/en-US/modules/server-installation.xml index 6b39bf664f..c702020844 100755 --- a/docbook/reference/en/en-US/modules/server-installation.xml +++ b/docbook/reference/en/en-US/modules/server-installation.xml @@ -843,27 +843,25 @@ All configuration options are optional. Default value for directory is
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/. + The Keycloak server can be installed as the default web application. In doing so, the server can be referenced at http://mydomain.com/ instead of http://mydomain.com/auth. - To do this, you need to add a default-web-module attribute in the Undertow subystem in standalone.xml. + To do this, add the 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. + keycloak-server.war is the runtime name of the Keycloak server application. Note that the WAR file does not exist as a file. If its name changes (ie. keycloak-server.war) in the future, find its new name from the Keycloak log entry with runtime-name:. - 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 + If you have run your server before altering the root context, your database + will contain references to the old /auth context. 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.