Open Closed

ABP Studio CLI fails to install with .NET 8 #10407


User avatar
0
r.abouzid created

hello I am trying to use ABP tooling with .NET SDK 8.0.x (LTS) on Windows. When installing or updating the ABP Studio CLI , the installation consistently fails with the following error: The settings file in the tool's NuGet package is invalid: Settings file 'DotnetToolSettings.xml' was not found in the package. Context:

  • .NET SDK version: 8.0.401
  • OS: Windows
  • NuGet sources: only https://api.nuget.org/v3/index.json
  • Global tool cache and NuGet caches were fully cleared

I want to standardize on .NET 8 and avoid using preview SDKs if possible.

Markdown supported.
Copy, paste, or drag & drop images and files (max 100 MB per file, 100 MB total per post)

2 Answer(s)
  • User Avatar
    -1
    AI-Bot created
    Support Team ABP Agent
    • This error is not caused by .NET 8 itself. It happens when the NuGet package of the global tool is downloaded/available, but its “.NET tool metadata” inside the nupkg is not what dotnet tool install/update expects (it can manifest exactly as: “Settings file 'DotnetToolSettings.xml' was not found in the package.”).
    • The verified/fixable approach on your side is to install ABP tooling via the correct package and ensure you’re not mixing the legacy CLI tool with the Studio CLI, then pin a known-good version if needed.

    Do this (works with .NET 8)

    1. Uninstall all ABP CLI global tools (both possible names)
    dotnet tool uninstall -g Volo.Abp.Cli
    dotnet tool uninstall -g Volo.Abp.Studio.Cli
    
    1. Clear the tool installation folder (optional but helps when metadata got cached oddly)
    • Delete:
      • %USERPROFILE%\.dotnet\tools\.store\volo.abp.studio.cli
      • %USERPROFILE%\.dotnet\tools\.store\volo.abp.cli (if exists)
    1. Install the new ABP Studio CLI (this is the correct tool for ABP Studio / new templates)
    dotnet tool install -g Volo.Abp.Studio.Cli
    
    1. Verify
    abp --version
    

    If it still fails: pin a specific version

    Sometimes a specific published version can have packaging/metadata issues. Pinning avoids “latest” until the fixed package is pulled:

    dotnet tool install -g Volo.Abp.Studio.Cli --version <x.y.z>
    

    Notes

    • ABP’s new CLI (used with ABP Studio) is Volo.Abp.Studio.Cli, and it replaced the legacy Volo.Abp.Cli in v8.2+; having both installed can create confusing outcomes, so remove the legacy one first.

    Links (validated):

    • https://abp.io/docs/latest/cli/index
    • https://www.nuget.org/packages/Volo.Abp.Studio.Cli
    • https://abp.io/docs/latest/studio

    This response was generated by AI. If it didn’t solve your problem, feel free to post a new answer — our support team will jump in to help you soon.

    Markdown supported.
    Copy, paste, or drag & drop images and files (max 100 MB per file, 100 MB total per post)
  • User Avatar
    1
    maliming created
    Support Team Fullstack Developer

    hi

    The latest CLI is targeted at net10.0. You can consider installing the NET 10.0 SDK.

    https://www.nuget.org/packages/Volo.Abp.Studio.Cli


    Or you can try to create a globaljson file

    > cd TestFolder
    TestFolder > dotnet new globaljson --sdk-version 8.0.401
    
    TestFolder > dotnet --version
    8.0.401
    
    TestFolder > dotnet tool install --global Volo.Abp.Studio.Cli --version 2.1.9
    
    Markdown supported.
    Copy, paste, or drag & drop images and files (max 100 MB per file, 100 MB total per post)
Boost Your Development
ABP Live Training
Packages
See Trainings
Mastering ABP Framework Book
The Official Guide
Mastering
ABP Framework
Learn More
Mastering ABP Framework Book
Made with ❤️ on ABP v10.8.0-preview. Updated on September 28, 2026, 11:44
1
ABP Assistant
🔐 You need to be logged in to use the chatbot. Please log in first.