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