dotnet-nuget-locals(1)

dotnet nuget locals

This article applies to: ✔️ .NET 6 SDK and later versions

NAME

dotnet-nuget-locals - Clears or lists local NuGet resources.

SYNOPSIS

    dotnet nuget locals <CACHE_LOCATION> [(-c|--clear)|(-l|--list)] [--force-english-output]

    dotnet nuget locals -h|--help

DESCRIPTION

The dotnet nuget locals command clears or lists local NuGet resources in the http-request cache, temporary cache, or machine-wide global packages folder.

ARGUMENTS

•   CACHE_LOCATION

    The cache location to list or clear. It accepts one of the following values:

    •   all - Indicates that the specified operation is applied to all cache types: http-request cache, global packages cache, temporary cache, and plugins cache.

    •   http-cache - Indicates that the specified operation is applied only to the http-request cache. The other cache locations aren’t affected.

    •   global-packages - Indicates that the specified operation is applied only to the global packages cache. The other cache locations aren’t affected.

    •   temp - Indicates that the specified operation is applied only to the temporary cache. The other cache locations aren’t affected.

    •   plugins-cache - Indicates that the specified operation is applied only to the plugins cache. The other cache locations aren’t affected.

OPTIONS

•   --force-english-output

    Forces the application to run using an invariant, English-based culture.

•   -?|-h|--help

    Prints out a description of how to use the command.

•   -c|--clear

    The clear option executes a clear operation on the specified cache type. The contents of the cache directories are deleted recursively. The executing user/group must have permission to the files in the cache directories. If not, an error is displayed indicating the files/folders that weren’t cleared.

•   -l|--list

    The list option is used to display the location of the specified cache type.

EXAMPLES

•   Displays the paths of all the local cache directories (http-cache directory, global-packages cache directory, temporary cache directory, and plugins cache directory):

        dotnet nuget locals all -l

•   Displays the path for the local http-cache directory:

        dotnet nuget locals http-cache --list

•   Displays the path for the local plugins cache directory:

        dotnet nuget locals plugins-cache --list

•   Clears all files from all local cache directories (http-cache directory, global-packages cache directory, temporary cache directory, and plugins cache directory):

        dotnet nuget locals all --clear

•   Clears all files in local global-packages cache directory:

        dotnet nuget locals global-packages -c

•   Clears all files in local temporary cache directory:

        dotnet nuget locals temp -c

•   Clears all files in local plugins cache directory:

        dotnet nuget locals plugins-cache -c

  Troubleshooting

For information on common problems and errors while using the dotnet nuget locals command, see Managing the NuGet cache.