How to change the Crowd Base URL
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Purpose
To change the Crowd Base URL
Solution
Changing the base URL for unproxied addresses
If you're accessing Crowd over the IP:
- Edit the
<crowd_home>/crowd.propertiesfile and change the following properties to alter the base URL:crowd.server.urlapplication.login.url
For example, old configuration:
#Tue Aug 01 19:20:30 BRT 2017
session.lastvalidation=session.lastvalidation
session.tokenkey=session.tokenkey
crowd.server.url=http\://localhost\:8095/crowd/services/
application.name=crowd
http.timeout=30000
session.isauthenticated=session.isauthenticated
application.login.url=http\://localhost\:8095/crowd
session.validationinterval=0
application.password=pGS5nqLO8CT94k7
New configuration:
#Tue Aug 01 19:20:30 BRT 2017
session.lastvalidation=session.lastvalidation
session.tokenkey=session.tokenkey
crowd.server.url=http\://192.168.132.36\:8095/crowd/services/
application.name=crowd
http.timeout=30000
session.isauthenticated=session.isauthenticated
application.login.url=http\://192.168.132.36\:8095/crowd
session.validationinterval=0
application.password=pGS5nqLO8CT94k7
For proxied addresses
If you're changing the base URL to work with your proxied address (Proxying Atlassian Server applications), use the example below:
Old configuration:
#Tue Aug 01 19:20:30 BRT 2017
session.lastvalidation=session.lastvalidation
session.tokenkey=session.tokenkey
crowd.server.url=http\://localhost\:8095/crowd/services/
application.name=crowd
http.timeout=30000
session.isauthenticated=session.isauthenticated
application.login.url=http\://localhost\:8095/crowd
session.validationinterval=0
application.password=pGS5nqLO8CT94k7
New configuration:
#Tue Aug 01 19:20:30 BRT 2017
session.lastvalidation=session.lastvalidation
session.tokenkey=session.tokenkey
crowd.server.url=http\://crowd.mydomain.com/crowd/services/
application.name=crowd
http.timeout=30000
session.isauthenticated=session.isauthenticated
application.login.url=http\://crowd.mydomain.com/crowd
session.validationinterval=0
application.password=pGS5nqLO8CT94k7
For details on what each property relates to please refer to our documentation on the The crowd.properties file
For Crowd 3.0 and later
- Log in to the Crowd Administration Console.
- Click the 'Cog Icon' button in the top navigation bar, then General.
- The 'General options' screen appears. Type the new base URL in the appropriate field. For example:
- http://mycompany:8095/crowd
- https://crowd.mycompany.com
- Click the 'Update' button.
After the change, if there are other applications accessing Crowd, the crowd.properties file for each of those applications will need to be updated to reflect this change.
Also, after the change, add the publicly-facing URL and IP address at Crowd Administration > Applications > Crowd > Remote Addresses and at the Trusted Proxy Servers menu.