TeamCity integrates with NuGet package manager and provides:

  • NuGet build runners are only supported on build agents running Windows OS.
  • NuGet build runners runners require an appropriate version on .NET Framework installed on the agent machine depending on the NuGet.exe version used: NuGet 2.8.6+ requires .NET 4.5+, earlier NuGet versions require .NET 4.0.
  • To use packages from an authenticated feed, see the NuGet Feed Credentials build feature.

On this page:

Typical Usage Scenarios

Installing NuGet to TeamCity agents

The NuGet trigger and the NuGet-related build runners require the NuGet command line binary configured on the server. They are automatically distributed to agents once configured.

To install NuGet.exe on TeamCity:

  1. Go to the Administration | Tools tab.
  2. Click Install tool and select NuGet.exe.
  3. Select whether you want to download (default) NuGet from the public feed or upload your own NuGet package containing NuGet.exe.

    a) If the Download radio button is chosen, select the NuGet version to install on all build agents.

    It is recommended to use release versions of NuGet.

    b) If the Upload radio button is selected, choose your own NuGet package.
    Specify whether this NuGet version will be default using the related check-box. 

  4. Click Add to install the selected NuGet version.

 

Installing NuGet on agents results in agents upgrade.

Using TeamCity as NuGet Server

If for some reason you don't want to publish packages to public feed, e.g. you're producing packages that are intended to be used internally; you can use TeamCity as a NuGet Server instead of setting up your own repository.

TeamCity running on any of the supported operating systems (Windows, Linux, Mac OS X) can be used as a NuGet Server.

To start using TeamCity as a NuGet Server, go to the Administration | NuGet Feed page (available to server system administrators), and click Enable. Two different links will be displayed on the page: for public (with guestAuth prefix) and private (with httpAuth prefix) feed. If Public Url is not available, you need to enable the Guest user login in TeamCity on the Administration | Global Settings page.

When the NuGet Server is enabled, all NuGet packages published as TeamCity build artifacts will be indexed and will appear in NuGet feed. The feed will include the packages from the build configurations where the currently authenticated user has permission to view build artifacts ("View project" permission).

When you have TeamCity NuGet server enabled:

If the build artifacts are changed under TeamCity Data Directory manually, you need to instruct TeamCity to reindex NuGet feed. For that, click "reset" link for "buildsMetadata" under Administration > Diagnostic > Caches.

(info) Internet Explorer settings may need to be set to trust the TeamCity Server when working in a mixed authentication environment.
For a step-by-step example of NuGet setup see blog post: Setting up TeamCity as a native NuGet Server.

{hidden-data}
* You don't need to install NuGet.exe Command Line tool on agents manually: [TeamCity can do it automatically|#installNuGet].
* To install NuGet packages without having to check them in to your VCS and update packages under solution use [NuGet Installer] build step.  
* build a NuGet package from a given spec file: [NuGet Pack].
* publish ({{push}}) your NuGet packages to a given feed (custom or default): [NuGet Publish] build runner.
*
{hidden-data}

Symbol Packages

Publishing of NuGet symbol packages to the internal TeamCity feed may cause issues when using an external source server. See the corresponding issue in our public tracker.


See also:

Administrator's Guide: NuGet Installer | NuGet Publish | NuGet Pack | NuGet Dependency Trigger