Removing the 'crowd' Context from the Application URL

For many different reasons, when using the Crowd distribution, you may want to access the Crowd console using http://localhost:8095 instead of http://localhost:8095/crowd.

To remove the /crowd part from the URL:


  1. In <Crowd-Install>/build.properties set the crowd.url variable to the following:

    # Crowd context root
    
    crowd.url=http://localhost:8095/
    
  2. Run <Crowd-Install>/build.sh (UNIX) or <Crowd-Install>\build.bat (Windows).

  3. Change your <Crowd-Install>/apache-tomcat/conf/server.xml file to include the following element in the Host section configuration:

    <Context path="" docBase="../../crowd-webapp" debug="0">
        <Manager pathname="" />
    </Context>

    Sample Host configuration:

           <Engine defaultHost="localhost" name="Catalina">
                <Host appBase="webapps" autoDeploy="true" name="localhost" unpackWARs="true">
                      <Context path="" docBase="../../crowd-webapp" debug="0">
                            <Manager pathname="" />
                      </Context>
                      <Valve className="org.apache.catalina.valves.ErrorReportValve"
                          showReport="true"
                          showServerInfo="false" />
                </Host>
           </Engine>
    
  4. Perform a backup of the crowd.xml file in <Crowd-Install>/apache-tomcat/conf/Catalina/localhost to another directory. 
  5. From <Crowd-Install>/apache-tomcat/conf/Catalina/localhost, remove the crowd.xml file to prevent Tomcat from loading the /crowd context. 
  6. After the restart, in the Server Settings screen, change the base URL.
Last modified on Apr 21, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.