Storing Symlinks in Artifactory

JFrog CLI supports uploading and downloading symlinks (soft links) between your local file system and Artifactory.

Note: The --symlinks option is supported only on Linux and macOS.

Symlinks are stored in Artifactory as zero-byte files with the following properties:

• symlink.dest: The path on the original file system to which the symlink points.
• symlink.destsha1: The SHA1 checksum of the value in the symlink.dest property.

Uploading Symlinks

To upload symlinks, run the jf rt upload command with the --symlinks option set to true.

Example:

jf rt upload "/path/to/symlink" my-repo/path/ --symlinks=true

Downloading Symlinks with Validation

When downloading symlinks stored in Artifactory, the CLI can validate that symlinks point to existing and unchanged files by comparing their SHA1 checksum. To add this validation, use the --validate-symlinks option with the jf rt download command.

Note: Symlink validation applies to files only, not directories.

Example:

jf rt download my-repo/path/symlink /local/path/ --validate-symlinks=true

If validation fails (e.g., the target file no longer exists or has been modified), the symlink will not be downloaded.