Configure General Settings
Set up the custom base URL and other general Artifactory settings for Federation members.
Configure general Artifactory settings such as the custom base URL, date format, and global offline mode. In a Federation, the custom base URL is critical because Federation members use it to communicate with each other.
Who can perform this task: Platform Administrators
Prerequisites:
- Admin access to the JFrog Platform
- For self-managed: access to the server's network configuration
Using the Platform UI
To configure general Artifactory settings:
- In the Administration module, navigate to Artifactory Settings > General Settings.
- Configure the following settings as needed.
| Setting | Description |
|---|---|
| Custom Base URL | The base URL used to access this Artifactory instance. Required for self-managed Federation members. |
| Server Name | A descriptive name for this Artifactory instance. |
| Date Format | The date display format used throughout the UI. |
| Global Offline Mode | When enabled, disables all remote repository communication. |
| Folder Download | Controls whether folder download is allowed and sets the max download size. |
| Trash Can | Enables or disables the trash can and configures the retention period. |
- Click Save.
Using the REST API
Retrieve or update general configuration using the General Configuration REST API:
GET /artifactory/api/system/configurationTo update:
PATCH /artifactory/api/system/configuration
Content-Type: application/yamlWarning
The Custom Base URL is blocked on SaaS platforms. You can only modify it if you're self-managed.
Federation Considerations
- Custom Base URL: Federation members use the custom base URL to identify and communicate with each other. Changing it on a member that participates in a Federation requires additional steps. See Change Base URL.
- Global Offline Mode: Enabling offline mode prevents the instance from communicating with remote Federation members. Synchronization pauses until the instance is brought back online, and events queue locally.
- Trash Can: Artifacts moved to the trash can are treated as deletions by Federation. When the trash can is emptied, deletion events propagate to all Federation members. Enabling or disabling the trash can is a per-instance setting and it isn't synchronized across members.
- General settings aren't synchronized across Federation members. Each member must be configured independently.
Frequently Asked Questions
This section provides answers to frequently asked questions.
FAQs
Q: Why is the custom base URL important for Federation members?
A: Federation members use the custom base URL to identify and communicate with each other. Changing it on a member that participates in a Federation requires additional steps. See Federation Considerations.
Q: Can I change the Custom Base URL on a JFrog SaaS instance?
A: No. The Custom Base URL is blocked on SaaS platforms; you can only modify it if you're self-managed.
Q: What happens to Federation sync when I enable Global Offline Mode?
A: Synchronization pauses until the instance is brought back online, and events queue locally in the meantime.
Q: Are general settings synchronized across Federation members?
A: No. General settings aren't synchronized; each Federation member must be configured independently.
Related Topics
Updated about 7 hours ago