Removing the 'crowd' Context from the Application URL

For many different reasons, when using the Crowd distribution (not EAR-WAR), 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 have the following Host section 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>
                </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 Nov 28, 2017

Was this helpful?

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