Removing the 'crowd' Context from the Application URL

For many different reasons, when using the Standalone distribution, 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. Move folder <Crowd-Install>/apache-tomcat/webapps/ROOT to a location outside the <Crowd-Install> folder.
   
   
2. 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/
   

   
   
   
3. Run <Crowd-Install>/build.sh (UNIX) or <Crowd-Install>\build.bat (Windows).
   
   
4. 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/
   

   
   
   
5. 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>
   

   
   
   
6. Run Crowd and access http://localhost:8095. You will be automatically redirected to the Crowd server console page.