There are various reasons why you may wish to change Bamboo's context path. Two of those are:
- You are running Bamboo behind a proxy.
- You have another Atlassian application, or Java web application, available at the same hostname and context path as Bamboo, and are experiencing login problems.
Upgrade Note
Since the manual steps of this process modify your Bamboo distribution, you will need to repeat Steps 1-6 each time you upgrade.
Changing the context path for Bamboo:
- Navigate to the directory where you are running Bamboo from. This is the install directory that you extracted the Bamboo distribution to, not Bamboo home.
- Stop Bamboo. This can be done using /
bin/stop-bamboo.baton Windows or /bin/stop-bamboo.shon OSX or Linux. Edit
conf/server.xmland find the element below:<Context path="" docBase="${catalina.home}/atlassian-bamboo" reloadable="false" useHttpOnly="true"/>Update the
pathattribute to reflect the context path that you want Bamboo to be accessible at, e.g. "/bamboo":<Context path="/bamboo" docBase="${catalina.home}/atlassian-bamboo" reloadable="false" useHttpOnly="true"/>Then save the file.
- Start Bamboo using /
bin/start-bamboo.baton Windows or /bin/start-bamboo.shon OSX or Linux.
Bamboo should now be available at the same host as before under the new context path. For example a server that was at http://localhost:8085 will now be reachable at http://localhost:8085/bamboo. Once Bamboo has started, go to the administration area and click General Configuration (under 'System'). Add the new context path to your base URL:
https://my-bamboo-hostname:8085/bamboo
保存をクリックします。
Bamboo + Apache
Note that if you are running Bamboo behind Apache:
- You will need to make sure that the host or context path that Bamboo is exposed on is not also being used by another web application that is listening on a different port.
- If you have updated the Bamboo context path using the steps outlined above, you will need to update your Apache configuration, as described in Integrating Bamboo with Apache HTTP Server.
4 Comments
Erik Saline [BlackPearl PDM]
Jan 23, 2014A new install for Bamboo on Windows does not include a server.xml file. Creating the server.xml file and adding the element does not work in Step 3.
Sepideh Setayeshfar
Jan 23, 2014Hi Erik,
Which Windows package did you use? Are you looking at <bamboo-installation-directory>/conf for the "server.xml" file?
Erik Saline [BlackPearl PDM]
Jan 24, 2014I was using Bamboo 4.3.4 http://www.atlassian.com/software/bamboo/downloads/binary/atlassian-bamboo-4.3.4-windows-x64.exe, I was not aware this was a Bamboo 5.3 page.
NathanA
Jan 30, 2014Hi Erik,
Yes, this is the Bamboo 5.3 (Latest) section.
Have a look in Bamboo 4.3 for information relevant to your version, or alternatively upgrade to the newest release.
Cheers,
Nathan