Changing the Port that Crowd uses

By default, Crowd is configured to use port 8095. If this port is already in use within your network, you will need to change the port that Crowd uses.

Follow these steps:

1. Change the Ports which Crowd Listens On

   Default <Crowd-Installation>/apache-tomcat/conf/server.xml file

   <Server port="8020" shutdown="SHUTDOWN">
   
       <Service name="Catalina">
   
           <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8095" redirectPort="8443" useBodyEncodingForURI="true" URIEncoding="UTF-8"/>
   ...

   Modified <Crowd-Installation>/apache-tomcat/conf/server.xml file - using server port 8021 and connector port 8093

   <Server port="8021" shutdown="SHUTDOWN">
   
       <Service name="Catalina">
   
           <Connector acceptCount="100" connectionTimeout="20000" disableUploadTimeout="true" enableLookups="false" maxHttpHeaderSize="8192" maxThreads="150" minSpareThreads="25" port="8093" redirectPort="8443" useBodyEncodingForURI="true" URIEncoding="UTF-8"/>
   ...

2. Edit the build.properties file, as described in Important Directories and Files.
   1. Change the crowd.tomcat.connector.port to the new port on which the Crowd Administration Console will be accessed.
   2. Change the crowd.url property to the new port on which the Crowd Administration Console will be accessed.
   3. Change the demo.url property to the new port on which the Crowd 'demo' application will be accessed.
   4. Change the openidserver.url property to the new port on which the CrowdID Server will be accessed.

3. Run the build.sh (or build.bat) script, as described in Important Directories and Files.

4. Change your Crowd Server Base URL to reflect the port changes as per outlined in our How To Change The Crowd Base URL KB.

   e.g. in this case, the updated Crowd's Server Base URL would be http://localhost:8093

RELATED TOPICS

• Supported Platforms
  • Setting JAVA_HOME
  • End of support announcements for Crowd
• Installing Crowd and CrowdID
  • Connecting Crowd to a Database
    • HSQLDB
    • MS SQL Server
    • MySQL
    • Oracle
    • PostgreSQL
  • Connecting CrowdID to a Database
    • HSQLDB for CrowdID
    • MS SQL Server for CrowdID
    • MySQL for CrowdID
    • Oracle for CrowdID
    • PostgreSQL for CrowdID
  • Specifying your Crowd Home Directory
• Running the Setup Wizard
  • Troubleshooting your Configuration on Setup
• Configuring Crowd
  • Important directories and files
    • The crowd.properties file
  • Changing the Port that Crowd uses
  • Configuring Crowd to Work with SSL
  • Installing Crowd as a Windows Service
    • Specifying Startup Order of Windows Services
    • Changing the User for the Crowd Windows Service
    • Removing the Crowd Windows Service
    • Troubleshooting Crowd as a Windows Service
  • Setting Crowd to Start Automatically on Mac OS X
  • Setting Crowd to Run Automatically and Use an Unprivileged System User on UNIX