Overview

JFrog Container Registry provides several Search Types you can use to search for artifacts in the Search module:

  • Quick: Search by artifact file name.
  • Package: Search for artifacts according to the criteria specific to the package format.
  • Archive Entries: Search for files that reside within archives (e.g. within a jar file).
  • Checksum: Search for artifacts based on their checksum value.
  • Trash Can: Search for artifacts in JFrog Container Registry's trash can

Additional advanced search features are available through the JFrog Container Registry REST API, including an advanced Artifactory Query Language. You can also browse through repositories using the Artifact Repository Browser.

Search in JFrog Container Registry provides true real-time results that always reflect the current state of the repository with no need to periodically rebuild indexes. Therefore, search results will immediately show any artifacts deployed, and will not show any artifacts removed. The * and ? wildcards are supported in your search term to help you narrow down your search. After conducting a search, you can hover over any result item for available actions such as:

Download
Download the artifact
Show in Tree
Displays the artifact within the Tree Browser where you can view its full details
Delete
Delete the artifact

When searching with the JFrog Container Registry UI, JFrog Container Registry performs prefix matching for search terms in all the different search modes. For example, searching for jfrog is equivalent to searching for jfrog*. You can still use the * and ? wildcards by placing in your search term in double-quotes to help you narrow down your search (for example, "a*.jar").


General

The different search features are available in the Search moduleTo start a search, simply select the search method you want to use.

Each search method offers a set of input fields corresponding to the type of search you have selected to help narrow down your search. For example, you can always narrow down your search by Selecting Limit to Specific Repositories as one of your search criteria.


For all searches, the search term is case-sensitive.


Quick Search

Using Quick Search you can search for artifacts by name. Select Quick, enter your search term and then click the "Search" button.

For readability, you can limit the number of results displayed by setting the following two parameters in the $ARTIFACTORY_HOME/etc/artifactory.system.properties file:

## Maximum number of results to return when searching through the UI
#artifactory.search.maxResults=500

## The backend limit of maximum results to return from sql queries issued by users. Should be higher than maxResults.
#artifactory.search.userQueryLimit=1000

You can also run a Quick Search from any screen using the search field in the top-right corner of the screen.

Quick Search Shortcut


Archive Search

Archive search performs a search for all files that match your search parameters in an archive. Typical examples are a zip or jar file, however, all file types defined in the MIME types configuration are supported. You can specify the following parameters for your search:

Name
The term to search for within the file name.
Path
Allows you to specify a path filter for the search.
Search class resources only
When checked, only class resources are searched. Any other file type is filtered out of the search.
Exclude Inner Classes
When checked, inner classes are excluded from the search.
Limit to Specific Repositories
Limits search to the specified repositories.

You can hover over a class file and select View to view the corresponding source file if it's available.


Package Search

Package search enables you to run a search based on a specific packaging type. For each type, you can specify search parameters based on the relevant metadata for the selected package type. For example, Docker search is suitable for searching through Docker repositories.


The following table displays the parameters you may use for each package type:

Search typeSearch parameters
Docker
Full Image Namespace, Image Tag, Image Digest
Helm

Package name, Version

All these search fields support the "?" and "*" wildcard characters.

For most package formats, package search is implemented as an AQL query. Click the "AQL" button to view the AQL query used in the search. You may also click the "Copy" icon in the AQL code snippet to copy the query to your clipboard.

When limiting search to specific repositories, JFrog Container Registry will only let you select repositories with the corresponding package type. Package search depends on those repositories having the correct layout. Searching through repositories with the wrong layout will have unpredictable and unreliable results.

The example below shows the results of searching for any Docker image with "mysql" in its name:

Search for a Docker Image

Package search is based on standard properties that JFrog Container Registry attaches to packages according to their type. 



Checksum Search

JFrog Container Registry allows you to search for artifacts based on MD5, SHA1 or SHA2 checksum value.

This can be especially useful if you want to identify an artifact whose name has been changed.

Wildcard characters are not supported in Checksum Search, so the term entered in the search field must be a valid MD5 or SHA1 value.


Search Checksum

Trash Can

JFrog Container Registry lets you search for artifacts you have "removed" to the trash can by selecting Trash Can as the Search Type.

Enter the artifact's name in the Query field, or use Add search criteria... and enter the artifact's checksum.

Search Trash Can