Viewing Packages

View packages in Artifactory, filter the list, and open version details.

The Packages list provides information about all the packages stored in all repositories in JFrog Artifactory. You have quick access to the most important summary information about the latest package versions and you can drill down for more details about previous versions.

To display the Packages list, in the Platform module, go to Artifactory > Packages. From the Packages list, you can:

New_Package_UI_5.png

The first display of the Packages lists shows all packages sorted lexicographically.

Use Package Filters

You can use filters, custom views, and other tools to narrow down which packages appear in the Packages list.

Filter the Packages List

The initial Packages list displays all packages stored on Artifactory. To use this list, you can filter by package type, package name, and other criteria so only the packages you want to view appear.

To filter the packages list:

  1. In the All Packages list, go to Filters.

    Filter_packages.png
  2. Filter the Packages list by any of the following:

    • Package Type: Choose one or more package types. For example, if you choose Docker and Maven, the filter lists all Docker and Maven packages stored on Artifactory.

    • Package Name: Enter a full or partial name. Wildcard search is applied to both the prefix and suffix of the text you enter. For example, if you enter thon and there is a package with the full name python, the filter lists the package.

    • Description: Enter text from the metadata description of the package version.

    • Keywords: If you are looking for packages that have keywords, enter the keyword here. Only one keyword is allowed.

    • Created On: Choose from Last 7 Days, Last 30 Days, Last 90 Days, or Custom. This filter uses the creation date of the first package version.

📘

Note

This filter uses the creation date of the first package version.

When you apply a filter option, a green dot indicates that the option is applied.

Save Filters as Custom View

After filtering the Packages list to display the packages you want to review, you can save the filter as a custom view and come back to it later.

To save a filter as a custom view:

  1. In Filters, click Save New View.

    The View Name window appears.

  2. Enter a descriptive name for the view. Use a short name because the UI has limited space for it.

  3. Click Save.

    The view is saved and appears as a tab alongside Recently Viewed and All Packages.

You can create up to 8 custom views. You can create custom views only from the All Packages tab. Your browser saves custom views in its cache.

Once you've saved a view, there are further actions you can perform on it such as renaming the view, deleting it, or making it your default view. For more information, see Manage Custom Views.

📘

Note

  • You can create up to 8 custom views.
  • You can update your saved filters or custom views. For more information, see Update Custom View.
  • You can create custom views only from the All Packages tab.
  • Your browser saves custom views in its cache.

Update Custom View

Once you've created a custom view, you can update it.

To update a custom view:

  1. Click the Custom View.
  2. In Filters, click Update Custom View.

Manage Custom Views

Once you've created a custom view, there are further actions you can perform on it such as renaming the view, deleting it, or making it your default view.

To perform an action on a custom view:

  1. Hover over the Custom View so that the actions button appears.

    Packages_filter_view.png
  2. Click the actions button.

    A dropdown list appears.

    Packages_filter_view_drop_down3.png
  3. From the list, choose the action that you want to perform on the view.

Recently Viewed Packages

The Recently Viewed view displays up to 10 most recently viewed packages. When you click a package in the list to view its details, Artifactory adds that package to the Recently Viewed list.

View Package Details

Package Details shows important information about package versions in a user-friendly and developer-native format. You can also get installation commands for every package version on each supported client, including multi-repository support if the package version exists in more than one location.

To view package details:

  • Click anywhere on the row of that package in the Packages List page. The Package Details page appears and displays details for the latest package version or tag.

Package Details Fields

Package Details provides information on a selected package version, including the following.

FieldDescription
Version/TagThe version number or Tag ID of the currently displayed package version.
Published DateThe date that this package version was published.
Version Downloads

The number of times the currently displayed package version or tag has been downloaded.

For Docker and Open Container Initiative (OCI) packages, this count is per tag. When shared-digest download statistics are enabled, pulling any tag or digest that shares a manifest digest updates download statistics for all tags you can read that reference that digest in the same repository and image name.

Vulnerabilities

If JFrog Xray has scanned the package version, the results of the security scan appear in this field. To display more information on the package vulnerabilities, hover over one of the vulnerability rectangles with your mouse. A legend appears.

LicensesThe names of the licenses covering the package.

Additional Package Information

The Package Details page displays additional information in the main pane.

TabDescription
InfoGeneral package version information. For Docker, Helm OCI, and OCI package versions, shows the Manifest or List Manifest for Docker and OCI images.
ReadmeReadme documentation for the package version, if available.
RepositoriesArtifactory repositories where the package version exists. Select Show in Artifacts Tree from the actions menu to see the artifact in its repository context on the Artifacts page.
BuildsSelect one of the following views to display build information about the package version.
  • Produced By: Displays information about the builds that produced the package version.
  • Used By: Displays information about the builds that use the package version as dependencies.
The information includes the name, number, and creation date of each build. Click the build name to open the Build page with full information on the build.
Release BundlesRelease Bundles containing the package version, the Release Bundle Distribution status, and when they were last updated. Click the Release Bundle name to view the Release Bundle in the Distribution page.
EvidenceExternal evidence files associated with the package version. For more information, see View the Package Evidence Table.
Xray DataXray security data related to the package version. For more information, see Xray.

Select a Package Version or Tag

You can select which package version or tag you want to view details for in these ways:

Select from Quick Version Selector

You can use the version selector to quickly find a package version and display its relevant details.

To select a package with the version selector:

  1. In the Version menu, use one of these options:
    • Select a package version.
    • Enter a version in the text box.
  2. (Optional) If the package has release versions, select Release versions only to filter the list to release versions.

The details for the selected version or tag are displayed.

Select from All Package Versions

You can select a package version from a list of all package versions and their main details.

To select a package from all versions:

  1. On the Package Details page, select All Versions. A list of all package versions with their main details appears.

  2. (Optional) If the package has release versions, select Release versions only to filter the list to release versions.

  3. Click a package version. The version is selected and its package details are displayed.

Multi-Client Install Commands

The Package Details provide package install commands for all supported package management clients. For example, Docker packages include installation instructions for both Docker and Podman. If the package version exists in more than one repository, you can select which repository to install from in the list.

The install command populates based on your selected client and repository, and you can copy it and use it to install the package version. For multi-line commands, only the first line is displayed. Click Show more to view the full command.

📘

Note

Some package clients use explicit authentication and require a token in the installation command. For these package types, a Generate Token prompt appears before the installation command is displayed. Enter your JFrog account password and click Generate Token to generate an install command pre-populated with your credentials.

Related Topics


Did this page help you?