Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata

Overview

Artifactory 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).
  • Property: Search for artifacts based on names and values of properties assigned to them.
  • Checksum: Search for artifacts based on their checksum value.
  • JCenter: Search for artifacts in Bintray's JCenter repository.
  • Trash Can: Search for artifacts in Artifactory's trash can

Additional advanced search features are available through the REST API.

Search in Artifactory 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

Using wildcards

When searching with the Artifactory UI, Artifactory 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").

Page Contents


General

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

Search Methods

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 toSpecific Repositories as one of your search criteria.

Searching specific repositories

 

Case Sensitive

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.

Quick Search

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:

Configuring the number of search results
## 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 run a Quick Search from any screen

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.

Search Archive

 

View the source file

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.

Package Search

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

Search typeSearch parameters
Bower
Package name, Version
CocoaPods
Package name, Version
Composer
Package name, Version
Conan
Package name, Version, User , Channel, OS, Architecture, Build Type, Compiler
Debian
File name (without the .deb extension), Distribution, Component, Architecture
Docker
Full Image Namespace, Image Tag, Image Digest
Gems
Package name, Version
Maven GAVC
Group ID, Artifact ID, Version, Classifier
Npm
Package name, Version, Scope
NuGet
Package ID, Version
Opkg
Package name, Version, Architecture, Priority, Maintainer
PyPI
Package name, Version
RPM
Package name, Version, Architecture, Release
Vagrant
Box Name, Version, Provider

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

Package search as an AQL query

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.

Limit search to specific repositories

When limiting search to specific repositories, Artifactory 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

Under the hood

Package search is based on standard properties that Artifactory attaches to packages according to their type. For example, when searching for NuGet packages, Artifactory is actually matching the search terms to the values for the nuget.id and nuget.version properties that should be attached to every NuGet package.

Limitation

Package search does not currently work on remote repository caches for RubyGems and Debian repositories.


Property Search

Artifactory Pro allows you to search for artifacts or folders based on Properties assigned to them, whether they are standard properties assigned by Artifactory, or custom properties which you can freely assign yourself.

To define your search parameters, in the Key field, enter the name of the property to search for, or select one from the list provided.

Then, in the Value field, set the value you are searching for in the specified property. To add more properties to the search use the Add search criteria  drop list.

You can repeat this process to specify any number of properties and values for your search.

Wildcards can be used in the Property Value field

You can use the "?" or "*" wildcards in the Value field.

Combining properties and values

Properties are combined using the AND operator.
Different values assigned to a specific property are also combined using the AND operator.
This means that only artifacts that meet all the search criteria specified will be found.

The example below shows a search for artifacts that have a build.number property with a value of 2

Search Property


Checksum Search

Artifactory 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 valid MD5 or SHA1 value.

The example below shows a search for an artifact using its SHA1 checksum. 

Search Checksum

JCenter

Bintray is JFrog's software distribution platform. Using this free cloud-based service, you can publish, download and share your binaries with the developer community.

For more details, please refer to the  JFrog website Bintray page.

Artifactory provides a direct connection to Bintray's JCenter repository which contains a comprehensive collection of popular Apache Maven packages.

To search for packages on Bintray, select JCenter as the Search Type and enter the name of the package you are looking for.

Search JCenter

You can hover over any search result and click Show in Bintray to display the selected artifact in Bintray.


Trash Can

Artifactory 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

 


Search Results Stash

Requires Artifactory Pro

This feature is available with an Artifactory Pro license

Artifactory maintains a stash where you can save search results. This provides easy access to artifacts found without having to run the search again and also provides a convenient way to perform bulk operations on the result set.

For details, please refer to Saving Search Results in the Stash.

  • No labels