Generic File Operations

The generic files commands allow you to perform common file operations in JFrog Artifactory, including uploading, downloading, copying, moving, deleting files, and managing file properties.

All commands in this section use the jf rt prefix for Artifactory operations.

Uploading Files

Upload files from the local file system to Artifactory.

Command

jf rt upload <source path> <target path> [command options]

Abbreviation: jf rt u

Arguments

Command Options

Examples

Example 1: Upload a single file to a repository:

jf rt u path/to/file.txt my-repo/path/

Example 2: Upload all .zip files from the current directory:

jf rt u "*.zip" my-repo/packages/

Example 3: Upload files while attaching properties:

jf rt u "*.jar" libs-release-local/org/acme/ --target-props="version=1.0;build=100"

Example 4: Upload and extract an archive:

jf rt u my-archive.zip my-repo/extracted/ --explode

Example 5: Upload using regular expression:

jf rt u "(.+)-sources\.jar" libs-release-local/{1}/ --regexp

Downloading Files

Download files from Artifactory to the local file system.

Command

jf rt download <source path> [target path] [command options]

Abbreviation: jf rt dl

Arguments

Command Options

Examples

Example 1: Download a single file:

jf rt dl my-repo/path/to/file.txt

Example 2: Download all .jar files to a local directory:

jf rt dl "libs-release-local/*.jar" ./libs/

Example 3: Download files filtered by properties:

jf rt dl "my-repo/releases/" ./downloads/ --props="version=1.0;status=released"

Example 4: Download and extract an archive:

jf rt dl my-repo/archives/package.zip ./extracted/ --explode

Example 5: Download the 10 most recently modified files:

jf rt dl "my-repo/builds/" ./latest/ --sort-by="modified" --sort-order="desc" --limit=10

Copying Files

Copy files from one location in Artifactory to another location within the same Artifactory instance.

Command

jf rt copy <source path> <target path> [command options]

Abbreviation: jf rt cp

Arguments

Command Options

Examples

Example 1: Copy a single file between repositories:

jf rt cp libs-snapshot-local/org/acme/1.0/ libs-release-local/org/acme/1.0/

Example 2: Copy all .jar files to another repository:

jf rt cp "libs-snapshot-local/*.jar" libs-release-local/releases/

Example 3: Copy files using placeholders:

jf rt cp "libs-snapshot-local/org/(.*)/(.*)/(.*)\.jar" "libs-release-local/org/{1}/{2}/{3}.jar" --regexp

Moving Files

Move files from one location in Artifactory to another location within the same Artifactory instance.

Command

jf rt move <source path> <target path> [command options]

Abbreviation: jf rt mv

Arguments

Command Options

Examples

Example 1: Move a file between repositories:

jf rt mv libs-snapshot-local/org/acme/artifact-1.0.jar libs-release-local/org/acme/

Example 2: Move all snapshot builds to release:

jf rt mv "libs-snapshot-local/org/acme/*-SNAPSHOT.jar" libs-release-local/org/acme/

Deleting Files

Delete files from Artifactory.

Command

jf rt delete <delete path> [command options]

Abbreviation: jf rt del

Arguments

Command Options

Examples

Example 1: Delete a single file:

jf rt del my-repo/path/to/file.txt

Example 2: Delete all .tmp files:

jf rt del "my-repo/**/*.tmp"

Example 3: Delete files without confirmation (CI mode):

jf rt del "my-repo/old-builds/" --quiet

Example 4: Dry run to preview what would be deleted:

jf rt del "my-repo/snapshots/" --dry-run

Searching Files

Search for files in Artifactory.

Command

jf rt search <search path> [command options]

Abbreviation: jf rt s

Arguments

Command Options

Examples

Example 1: Search for all .jar files:

jf rt s "libs-release-local/*.jar"

Example 2: Search with property filter:

jf rt s "my-repo/" --props="version=1.0;status=released"

Example 3: Count matching files:

jf rt s "my-repo/builds/" --count

Example 4: Search and return only specific fields:

jf rt s "my-repo/" --include="name;size;modified"

Example 5: Get the 5 largest files:

jf rt s "my-repo/" --sort-by="size" --sort-order="desc" --limit=5

Setting File Properties

Set properties on files in Artifactory.

Command

jf rt set-props <files pattern> <files properties> [command options]

Abbreviation: jf rt sp

Arguments

Command Options

Examples

Example 1: Set a single property:

jf rt sp "my-repo/path/to/file.jar" "status=released"

Example 2: Set multiple properties:

jf rt sp "my-repo/builds/1.0/" "version=1.0;env=production;approved=true"

Example 3: Set properties on files matching a pattern:

jf rt sp "libs-release-local/*.jar" "type=library"

Example 4: Set properties only in the specified repository (without traversing paths):

jf rt sp "my-repo/" "scanned=true" --repo-only

Deleting File Properties

Delete properties from files in Artifactory.

Command

jf rt delete-props <files pattern> <properties list> [command options]

Abbreviation: jf rt delp

Arguments

Command Options

Examples

Example 1: Delete a single property:

jf rt delp "my-repo/path/to/file.jar" "status"

Example 2: Delete multiple properties:

jf rt delp "my-repo/builds/1.0/" "temp,draft,wip"

Example 3: Delete properties from files matching a pattern:

jf rt delp "libs-release-local/*.jar" "snapshot,dev"

Example 4: Delete properties only in the specified repository:

jf rt delp "my-repo/" "temp-prop" --repo-only

Using File Specs

File specs are JSON files that define the source and target paths for file operations. They provide a more flexible and reusable way to specify complex operations.

Basic Structure

{
  "files": [
    {
      "pattern": "my-repo/path/to/files/*.jar",
      "target": "target-repo/path/",
      "props": "key1=value1;key2=value2",
      "recursive": "true",
      "flat": "false"
    }
  ]
}

Common Properties

Using a File Spec

jf rt upload --spec=upload-spec.json
jf rt download --spec=download-spec.json
jf rt copy --spec=copy-spec.json
jf rt move --spec=move-spec.json
jf rt delete --spec=delete-spec.json
jf rt search --spec=search-spec.json
jf rt set-props --spec=setprops-spec.json
jf rt delete-props --spec=deleteprops-spec.json

Example: Upload Spec

{
  "files": [
    {
      "pattern": "./build/libs/*.jar",
      "target": "libs-release-local/org/acme/{1}/",
      "props": "version=1.0;build.number=100"
    },
    {
      "pattern": "./build/docs/",
      "target": "docs-repo/acme/1.0/",
      "flat": "true"
    }
  ]
}

Example: Download Spec

{
  "files": [
    {
      "pattern": "libs-release-local/org/acme/*.jar",
      "target": "./libs/",
      "props": "version=1.0",
      "flat": "true"
    }
  ]
}