To apply a filter in either the Tree mode or the Simple mode, click the search icon, or start typing out the filter expression while on the browser.
- By repository name: To filter by repository name, just type the name you want to filter by
- By package type: To only display repositories for a particular package type, type pkg:<package type>. For example, typing
pkg:dockerwill filter out any repositories that are not Docker repositories
- By repository type: To only display particular repository types, type repo:<repository type>. For example, typing
repo:localwill filter out any repositories that are not local repositories. The options are local, cached, remote and virtual.
You can also click the filter option.
Note that these filters are saved as cookies in your browser.
Sorting, Filtering and Adding Favorite Repositories
You can view only the repositories you need by customizing the Artifact Repository Browser with your favorite repositories, and applying sort and filter options. Use as many different favorite, sort and filter combinations to narrow down the Artifact tree to display exactly what you need. Note that your filters and favourites are saved as cookies in your browser cache.
To tag a repository as a favourite :
Select the repository in the left pane, right-click and select Add to Favorites.
To view the list of favorite repositories, click the Favorites icon.
Tree browsing lets you drill down through the repository hierarchy and display full information about each level. For any repository, folder or artifact selected in the tree, a tabbed panel displays detailed data views and a variety of actions that can be performed on the selected item. The information tabs available are context sensitive and depend on the item selected. For example, if you select an npm package, an npm Info tab displays information specific to npm packages. Similarly for NuGet, RubyGems and any other supported package formats.
Click on the
Tree link at the top of the browser to collapse all open nodes in the tree.
Sorting the Tree Hierarchy
The default order in which repositories appear in the Tree hierarchy is: Distribution, Local, Remote, Virtual.
You can modify this order through the
artifactory.treebrowser.sortRepositories.sortByType system property.
For example, to reverse the order, you would set:
If you omit any repository type in the specified sort order, it will be ordered according to the default setting.
Simple browsing lets you browse repositories using simple path-driven URLs, which are the same URLs used by build tools such as Maven. It provides lightweight, view-only browsing.
A unique feature of this browsing mode is that you can also view remote repositories (when enabled for the repository), and virtual repositories to see the true location of each folder and artifact.
List Browsing lets you browse the contents of a repository outside of the Artifactory UI. It provides a highly responsive, read-only view and is similar to a directory listing provided by HTTP servers.
To use List Browsing, click the icon to the right of a repository name in the Artifact Repository Browser (indicated in red in the screenshot below).
Artifact Repository Browser
Creating public views with List Browsing
List browsing can be used to provide public views of a repository by mounting it on a well-known path prefix such as
list (see example below).
This allows the system administrator to create a virtual host that only exposes Artifactory's List Browsing feature to public users (while maintaining write and other advanced privileges), but limiting access to the intensive UI and REST API features for internal use only.
For a Smart Remote Repository, Artifactory lets you navigate the contents of the repository on the remote Artifactory instance even if the artifacts have not been cached locally.
To enable remote browsing, you need to set the List Remote Folder Items checkbox in the remote repository configuration. Once this is set you can navigate that repository using the Simple or List Browser.
In the Simple Browser, an item that is not cached is indicated by an icon on its right when you hover over the item. In the List Browser, an item that is not cached is indicated by an arrow.
Initial responsiveness of remote repositories
Initial remote browsing might be slow, especially when browsing a virtual repository containing multiple remote repositories. However, browsing speeds up since remote content is cached for browsing according to the Retrieval Cache Period defined in the remote repository configuration panel.
Viewing Artifact Information
Displays the Artifact metadata. Regardless of whether you select the item in Tree browsing mode or Simple browsing mode, one or more of the following tabs appear containing the metadata associated with the selected item.
|General Information including download statistics such as the total number of downloads, time stamp of last download and the last user who downloaded.|
For Maven artifacts, this section provides code snippets for common build tools' dependency declaration.
Virtual Repository Associations
|Indicates which virtual repositories "contain" the selected artifact.|
|Displays SHA1, SHA-256 and MD5 checksums automatically.|
Displays the list of permissions in the context of users, groups or permission targets on the artifact level. For more information, see Permissions.
Displays the list of properties annotating the selected item.
You can define the collections of properties called 'Property Sets' in the user interface. In each property-set you can define properties and for each property specify whether the property is open, single-value or multi-value. For more information, see Property Sets.
Displays the list of users following this item.
The Followers feature allows you to monitor selected artifacts, folders or repositories for storage events (create/delete/modify) and receive detailed email notifications on repository changes that are of interest to you.
You can add and remove Followers from the 'Followers' tab in the tree browser. Followers or folders intercept changes on all children. An admin or users with the "Manage" permission can view and manage followers via the 'Watches' tab in the tree browser.
Follow notifications are aggregated at around 1 minute intervals and sent in a single email message.
All notifications respect the read permissions of the watcher on the followed item(s).
Displays the list of builds that either produce or use the selected item.
Viewing Xray Data on Artifacts
You can view Xray data on the artifact level.
Indicates if, and when the last time the selected artifact was scanned by Xray, as well as the Top Severity for any vulnerabilities detected.
To override download blocking for a specific artifact, click Ignore Violation located on the right far side of the selected violation. For more information, see Analyzing Resource Scan Results.
View a List of Artifacts Containing Vulnerabilities
Use the Security & Compliance search to view a list of artifacts that contain Xray vulnerabilities. For more information, see Searching for Scanned Resources.
Restoring Artifacts from the Trash Can
You can easily recover items that have been inadvertently deleted from local repositories from the trash can.
The trash can can be enabled or disabled in the Trash Can Settings by an administrator or a user with the 'Manage' permission.
When enabled, the trash can is displayed at the bottom of the Artifact Repository Browser and it holds all artifacts or repository paths that have been deleted from local repositories for the period of time specified in the Retention Period field.
Right-click on an item in the trash can gives you the option to Refresh, Restore it to its original location, or Delete permanently.
Right-click on the trash can icon gives you the option to Refresh the whole trash can, Search Trash for specific items, or Empty Trash which means that all items in the trash can will be permanently deleted.
Click the pin icon to pin the trash can so it remains visible even if you scroll the tree.
The JFrog Platform fully supports browsing with WebDAV. For full details please refer to Using WebDAV.