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. In order to remove the /crowd part from the URL, you can take the following steps:

IMPORTANT: Before doing these changes in your production environment, please make sure that they will work in a test instance first.

  1. Edit file <Crowd-Install>/build.properties and make sure that variable crowd.url is set 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. In your <Crowd-Home-Directory>/crowd.properties file, make sure that the crowd.server.url and application.login.url URLs do not contain the /crowd part.

    crowd.server.url=http\://localhost\:8095/services/
    application.login.url=http\://localhost\:8095/
    
  4. 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>
    
  5. Perform a backup of the crowd.xml file in <Crowd-Install>/apache-tomcat/conf/Catalina/localhost to another directory. 
  6. Remove the crowd.xml file from <Crowd-Install>/apache-tomcat/conf/Catalina/localhost to prevent Tomcat from loading the /crowd context. 
  7. Run Crowd and access http://localhost:8095. You will be automatically redirected to the Crowd server console page.
Last modified on Sep 20, 2017

Was this helpful?

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