How to change the Crowd Base URL
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. 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
Summary
To change the Crowd Base URL
Solution
For Crowd 2.12 and below
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:
1
2
3
4
5
6
7
8
9
10
11
#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:
1
2
3
4
5
6
7
8
9
10
11
#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:
1
2
3
4
5
6
7
8
9
10
11
12
#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:
1
2
3
4
5
6
7
8
9
10
11
#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 About 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 Configuring Trusted Proxy Servers menu.
Was this helpful?