You must install or update .NET to run this application .NET Origin: Application & API Last updated 13 Oct 2026

The framework 'Microsoft.NETCore.App', version '8.0.0' (x64) was not found. You must install or update .NET to run this application

The machine doesn’t have the .NET runtime version the app was built for (framework-dependent deployment).

Exact message you may see You must install or update .NET to run this applicationThe framework 'Microsoft.NETCore.App', versionwas not foundMicrosoft.AspNetCore.App was not found
Explore the map of this error Full error map →
Seen on: .NET

Meaning

Framework-dependent apps need the exact major runtime (and ASP.NET Core runtime for web apps). Install it, roll forward, or publish self-contained.

Common causes

  • Runtime not installed (or only SDK of another version)
  • ASP.NET Core runtime missing (Microsoft.AspNetCore.App)
  • Architecture mismatch (x86 vs x64)
  • Docker base image with older runtime

⚡ Quick fix

  1. Install the runtime/Hosting Bundle for that version
  2. Publish self-contained (--self-contained -r linux-x64)
  3. Use the matching Docker base image (mcr.microsoft.com/dotnet/aspnet:8.0)

Detailed fix by platform

Shell

  1. csharp
    dotnet --list-runtimes
dotnet publish -c Release -r linux-x64 --self-contained true

How to diagnose

  1. Installed — dotnet --list-runtimes
  2. Required — runtimeconfig.json
  3. Arch — x64/x86/arm64

🔧 Still not fixed?

Many errors look alike. If the steps above didn’t solve it, one of these is probably what you’re facing:

Where this error sits

Origin: Application & API. Errors that are often confused with or caused by this one (click to open):

500.30 — HTTP Error 500.30 - ASP.NET Core app failed to start (.NET)500.30App Service Application Error — Azure App Service: ":( Application Error" / container didn’t respond to HTTP pings (Azure)App Service Applicati…ChunkLoadError — ChunkLoadError: Loading chunk 123 failed. (JavaScript)ChunkLoadErrorFileNotFoundException assembly — Could not load file or assembly 'X, Version=…' or one of its dependencies (.NET)FileNotFoundException…MIME type not executable — Refused to execute script from 'x' because its MIME type ('text/html') is not executable (JavaScript)MIME type not executa…module MIME type — Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "text/html" (JavaScript)module MIME typeNETSDK1045 — error NETSDK1045: The current .NET SDK does not support targeting .NET 8.0. Either target .NET 7.0 or lower, or use a version of the .NET SDK that supports .NET 8.0 (.NET)NETSDK1045OPcache stale code — PHP still runs old code after deploy (OPcache not reset) (PHP)OPcache stale codeYou must …

Explore the map of this error Full error map →

🧠 Still stuck? Analyze your error

Paste the full message, response headers or stack trace — we'll detect the platform and point to the most likely cause.

💬 What worked for others

No tips yet — did something else fix this for you?

Share what worked for you

Tips are checked by an editor before they appear. Links are removed.