Use NuGet with JFrog CLI

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

This topic covers the following tasks:

• Configure NuGet for Artifactory (jf nuget-config)
• Run NuGet commands (jf nuget)

When to Use

Choose the right command based on which tool you have installed:

• Have nuget CLI installed? → Use jf nuget (this page).
• Have dotnet SDK installed? → Use jf dotnet instead.

jf nuget requires the NuGet CLI binary (nuget) to be in your $PATH. It does not work with the .NET SDK CLI (dotnet). For projects using dotnet restore or dotnet build, use jf dotnet.

Prerequisites

• NuGet CLI installed and available in $PATH. Verify with:

  Bash

  nuget help

  If not installed:

  • macOS: brew install nuget
  • Linux: Download from nuget.org/downloads and add to $PATH.
  • Windows: Included with Visual Studio, or download from nuget.org/downloads.

• JFrog CLI server configured with jf config add or jf c add. Use a scoped access token (JWT). Reference tokens require a username — see Troubleshooting.

• Run jf nuget-config in the project directory before the first build.

• Artifactory NuGet repository exists and your account has read (and write, for push) permissions.

Configuration: jf nuget-config

Generate NuGet configuration for resolving packages through Artifactory. Run this once per project before your first build.

To configure NuGet for Artifactory:

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

Synopsis

jf nuget-config [options]

Aliases: nugetc

Configuration Options

Configuration Examples

View Help

jf nuget-config --help

Non-Interactive Configuration

Configure NuGet with non-interactive flags:

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

Where:

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

📘

Note

: Both --server-id-resolve and --repo-resolve are required for non-interactive use. Omitting either flag launches an interactive configuration wizard, which is not suitable for CI/CD pipelines.

For example:

jf nuget-config --server-id-resolve=my-server --repo-resolve=nuget-virtual

Why Run Config First?

You must run jf nuget-config before jf nuget restore. The config creates .jfrog/projects/nuget.yaml for NuGet package resolution through Artifactory. Without it, jf nuget 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 nuget' command on a project for the first time, the project should be configured with the 'jf nuget-config' command.

👍

Shortcut

: In CI/CD, pass all flags non-interactively so the config step is fully automated and reproducible.

Configuration Notes

• Run once per project: Re-run when changing the resolution repository.
• NuGet V2: Set --nuget-v2=true only if your Artifactory NuGet repository uses V2 protocol.
• Alternative: For .NET SDK projects, use jf dotnet for broader .NET integration.

Expected Output

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

How to Verify

After running, confirm the configuration exists:

cat .jfrog/projects/nuget.yaml

Expected contents:

version: 1
type: nuget
resolver:
    repo: <repo-name>
    serverId: <server-id>

Build: jf nuget

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

To run NuGet with Artifactory integration:

1. Run jf nuget-config in the project directory if you have not already (see Configuration).
2. Run jf nuget with the NuGet command and arguments, adding --build-name and --build-number when you want build-info (see Build Examples).

Synopsis

jf nuget <nuget-arguments> [options]

Aliases: none

Arguments

Build Options

Build Examples

Restore Packages

jf nuget restore

Expected output (success):

[Info] Running nuget...
[Info] Resolving packages from Artifactory...
MSBuild auto-detection: using msbuild version '...' from '...'
Restoring packages for <project>.csproj...
...
[Info] Building build-info...
[Info] Build-info successfully created.

Push with Build Information

jf nuget push <package-path> --build-name=<build-name> --build-number=<build-number>

Where:

• <package-path> is the path to the .nupkg file (for example, bin/Release/MyPackage.1.0.0.nupkg)
• <build-name> is a name for the build (for example, my-dotnet-app)
• <build-number> is a number or identifier for the build run (for example, 1)

For example:

jf nuget push bin/Release/MyPackage.1.0.0.nupkg --build-name=my-dotnet-app --build-number=1

Expected output (success):

[Info] Running nuget...
[Info] Pushing bin/Release/MyPackage.1.0.0.nupkg to nuget-virtual...
[Info] Build-info successfully created.

After collecting build info, publish it with:

jf rt build-publish my-dotnet-app 1

Important Notes

• NuGet v2 vs v3: Use --nuget-v2 in jf nuget-config if your Artifactory NuGet repository is configured for the V2 protocol.
• Insecure connections: The --allow-insecure-connections flag is for testing only. Do not use in production.
• Build-info: Use --build-name and --build-number, then publish with jf rt build-publish.
• Alternative: For .NET projects, jf dotnet provides similar functionality using the .NET CLI instead of NuGet directly.

Running Builds with MSBuild

JFrog CLI includes integration with MSBuild and Artifactory, allowing you to resolve dependencies and deploy build artifacts while collecting build-info. This is done by having JFrog CLI in your search path and adding JFrog CLI commands to the MSBuild .csproj file. For detailed instructions, refer to the MSBuild project example on GitHub.

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 NuGet
    run: jf nuget-config --server-id-resolve=setup-jfrog-cli-server --repo-resolve=nuget-virtual
  - name: Restore packages
    run: jf nuget restore --build-name=my-dotnet-app --build-number=${{ github.run_number }}
  - name: Publish build info
    run: jf rt build-publish my-dotnet-app ${{ github.run_number }}

Troubleshooting

Enable debug logging: export JFROG_CLI_LOG_LEVEL=DEBUG

Related Topics

• Build Tools Overview — Capabilities matrix and tool reference
• Native Mode — Supported packages with Native Mode