Administrators can change the base URL shared by the members of an active Federated repository. Changing the base URL might be necessary, for example, if the network topology has changed.
Important
This feature is available only when all Federation members are using Artifactory 7.55.1 or later.
The steps required to complete the change are dependent on whether the Federation uses the base URL or a special Federated base URL.
If a Federated base URL has been defined, the JPD publishes this address to all Federation members, who then use this address to access the Federated repository on the JPD instead of the standard base URL.
 |
 |
Warning
It is important to follow the instructions described in this topic, in particular, the procedure to generate new tokens when required. The Federation will not function properly without valid tokens.
Tip
Use the Config Descriptor to determine whether a Federated base URL has been defined. For more information, see Locate the Federated Base URL.
Possible Use Cases
When changing the base URL for Federated repositories, there are several possible use cases:
You want to change the base URL and no Federated base URL has been defined. In this case, perform Change the Base URL followed by Generate New Tokens for Federation Members.
You want to change the base URL without changing the existing Federated base URL. In this case, perform Change the Base URL. The tokens do not need to be regenerated.
You want to change the existing Federated base URL. In this case, perform Change the Federated Base URL followed by Generate New Tokens for Federation Members.
 |
In all cases, it is highly recommended to test the functionality of the Federation after changing either the base URL or the Federated base URL, as described in After Changing the Base URL.
Change the Base URL
Administrators can change the base URL directly from the JFrog platform UI, as described below.
To change the base URL:
In the Administration module, select General > Settings.
Enter a new custom base URL.
Click Save.
Do one of the following:
If no Federated base URL has been defined for this Federation, continue with Generate New Tokens for Federation Members.
If a Federated base URL has been defined, but it is being left unchanged, continue with After Changing the Base URL.
Note
It is also possible to change the custom base URL using the Update Custom URL Base REST API.
Important
As a fallback, it is possible to change the base URL more aggressively by canceling the Federation, changing the base URL, and then recreating the Federation. Please note this has a huge impact on the system since it requires recreating each Federated repository from scratch.