Use Yarn with JFrog CLI

Run Yarn commands with Artifactory integration for dependency resolution and build information collection.

This topic covers the following tasks:

• Configure Yarn for Artifactory (jf yarn-config)
• Run Yarn commands (jf yarn)

When to Use

Use jf yarn if your JavaScript project uses Yarn for dependency management and you want dependencies resolved from Artifactory. For npm or pnpm, configure Artifactory as your registry using the repository Set Me Up instructions and use the native client, or see the JFrog CLI reference for jf npm and jf pnpm-config.

Prerequisites

Yarn 2.4.0 or higher must be installed (Yarn Berry: 2.x, 3.x, or 4.x) for jf yarn in configured-registry (wrapped) mode. Yarn 1.x (Classic) is not supported. jf yarn set version blocks upgrading to Yarn 5.x or higher. 4.x is the maximum supported major version. Native Mode (JFROG_RUN_NATIVE=true) requires Yarn 4.0.0 or higher. See Native Mode.

To install a compatible version using Corepack (recommended):

corepack enable
corepack prepare yarn@stable --activate

Or using npm:

npm install -g yarn@berry

Note: Running npm install -g yarn without a version tag installs Yarn 1.x, which is not compatible with jf yarn. Always install Yarn 2.x, 3.x, or 4.x.

• Configure a server with jf config add or jf c add.
• Authentication to Artifactory is required.
• Run jf yarn-config in the project directory before the first build unless you use Native Mode with Yarn 4+.

Configuration: jf yarn-config

Note: See Prerequisites for supported Yarn versions per mode. Yarn 4.x only switches to Native Mode when JFROG_RUN_NATIVE=true is set. See Native Mode.

Generate Yarn configuration for resolving dependencies through Artifactory. Run this once per project before your first build (configured-registry mode).

To configure Yarn for Artifactory:

1. From your project directory, run jf yarn-config with --server-id-resolve and --repo-resolve (see Non-Interactive Configuration).
2. Confirm .jfrog/projects/yarn.yaml exists (see How to Verify).

Synopsis

jf yarn-config [command options]

Aliases: yarnc

Configuration Options

Configuration Examples

View Help

jf yarn-config --help

Non-Interactive Configuration

Configure Yarn with non-interactive flags:

jf yarn-config --server-id-resolve=<server-id> --repo-resolve=<repo-name>

Where:

• <server-id>: The server ID configured using jf c add
• <repo-name>: The name of the npm repository in Artifactory

For example:

jf yarn-config --server-id-resolve=my-server --repo-resolve=npm-virtual

Why Run Config First?

You must run jf yarn-config before jf yarn when using configured-registry mode (the default). The config command creates a .jfrog/projects/yarn.yaml file that directs dependency resolution through Artifactory. Without it, jf yarn does not know where to fetch packages.

If you skip this step, you will see the error:

no config file was found! Before running the 'jf yarn' command on a project for the first time, the project should be configured with the 'jf yarn-config' command.

Configuration Notes

• Resolution only: Yarn config supports dependency resolution but not deployment. To publish packages, use jf npm publish or native yarn npm publish (not via jf yarn).
• Run once per project: Re-run when changing the resolution repository.
• Yarn version: See Prerequisites for supported versions per mode.
• Not required in native mode: When JFROG_RUN_NATIVE=true and Yarn 4+ is installed.

Expected Output

$ jf yarn-config --server-id-resolve=my-server --repo-resolve=npm-virtual
[Info] yarn build config successfully created.

How to Verify

After running, confirm the configuration exists:

cat .jfrog/projects/yarn.yaml

Native Mode

Native mode runs Yarn using your project's existing .yarnrc.yml registry and authentication settings instead of injecting Artifactory credentials from jf yarn-config. Build information collection still runs when you pass --build-name and --build-number.

Example

export JFROG_RUN_NATIVE=true
jf yarn install --server-id=my-server --build-name=my-js-app --build-number=1
jf rt build-publish my-js-app 1

Note: Ensure .yarnrc.yml already points at your Artifactory npm virtual repository and includes valid authentication before using native mode.

Build: jf yarn

Run Yarn commands with Artifactory integration for dependency resolution and build information collection.

To run Yarn commands through Artifactory:

1. Run jf yarn-config in the project directory if you have not already (see Configuration).
2. From the project directory, run jf yarn with your Yarn command (for example, install) and optional build-info flags (see Build Examples).

Synopsis

jf yarn [yarn command] [command options]

Aliases: none

Arguments

Build Options

Build Examples

Install Dependencies

jf yarn install

Build with Build Information

jf yarn install --build-name=<build-name> --build-number=<build-number>

Where:

• <build-name>: A name for the build (for example, my-js-app)
• <build-number>: A number or identifier for the build run (for example, 1)

For example:

jf yarn install --build-name=my-js-app --build-number=1

Yarn Workspaces for Monorepos

For Yarn workspace projects, a single jf yarn install from the workspace root collects registry dependencies from all workspace members into one build-info module (when --build-name and --build-number are set).

Local workspace links (workspace:), link:, file:, portal:, patch:, and Git URL dependencies are not included in build-info because they do not exist in Artifactory.

Build Output Notes

The CLI generates a Trace ID at the start of every invocation and logs it at DEBUG level. If the command fails, the Trace ID is additionally printed at INFO level:

[Info] Trace ID for JFrog Platform logs: <id>

To see the Trace ID on a successful run, enable debug logging:

export JFROG_CLI_LOG_LEVEL=DEBUG

Provide this ID to JFrog Support to correlate client-side failures with server-side logs.

Important Notes

• Yarn version: See Prerequisites for supported versions per mode.
• Resolution only: Yarn config supports dependency resolution from Artifactory. Deployment (publish) is not supported via jf yarn — use jf npm publish or native yarn npm publish instead.
• Build-info: Use --build-name and --build-number, then publish with jf rt build-publish. Dependencies are collected only when both flags are provided.
• Native mode: See Native Mode for JFROG_RUN_NATIVE=true behavior with Yarn 4+.

CI/CD Example: GitHub Actions

# .github/workflows/build.yml
steps:
  - uses: actions/checkout@v4
  - name: Setup JFrog CLI
    uses: jfrog/setup-jfrog-cli@v4
    env:
      JF_URL: ${{ vars.JF_URL }}
      JF_ACCESS_TOKEN: ${{ secrets.JF_ACCESS_TOKEN }}
  - name: Configure Yarn
    run: jf yarn-config --server-id-resolve=setup-jfrog-cli-server --repo-resolve=npm-virtual
  - name: Install dependencies
    run: jf yarn install --build-name=my-js-app --build-number=${{ github.run_number }}
  - name: Publish build info
    run: jf rt build-publish my-js-app ${{ github.run_number }}

For Yarn 4+ projects that already configure Artifactory in .yarnrc.yml:

  - name: Install dependencies (native mode)
    env:
      JFROG_RUN_NATIVE: "true"
    run: jf yarn install --server-id=setup-jfrog-cli-server --build-name=my-js-app --build-number=${{ github.run_number }}

Troubleshooting

Enable debug logging: export JFROG_CLI_LOG_LEVEL=DEBUG

Frequently Asked Questions

This section provides answers to frequently asked questions about using Yarn with JFrog CLI.

Related Topics

• Build Tools Overview
• Native Mode
• Use JFrog CLI Package Alias
• Supported Package Manager Versions