Skip to content

docs: document YARP WithStaticFiles + WithDockerfile /wwwroot path requirement #505

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Copilot wants to merge 2 commits into
base: main
Choose a base branch
from
+18 −0
Draft

docs: document YARP WithStaticFiles + WithDockerfile /wwwroot path requirement #505

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
cd395dd
Initial plan
Copilot Mar 4, 2026
9b35144
docs: add WithStaticFiles + WithDockerfile documentation for YARP /ww…
Copilot Mar 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions src/frontend/src/content/docs/integrations/reverse-proxies/yarp.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -174,6 +174,24 @@ var frontend = builder.AddYarp("frontend")
.WithDockerfile("../npmapp");
```

When using `WithStaticFiles()` together with `WithDockerfile()`, the YARP container expects static files to be placed at the `/wwwroot` directory inside the container. Your Dockerfile must use the YARP base image (`mcr.microsoft.com/dotnet/nightly/yarp`) as its final stage so the YARP server can start and serve the files. The following example shows a multi-stage Dockerfile that builds a Node.js frontend app and copies the output to `/wwwroot`:

```dockerfile title="Dockerfile"
FROM node:22-slim AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

FROM mcr.microsoft.com/dotnet/nightly/yarp
COPY --from=build /app/dist /wwwroot
```

<Aside type="caution">
If the built assets aren't copied to `/wwwroot`, the container starts successfully but returns 404 for all static file requests. Look for the log message `The WebRootPath was not found: /wwwroot. Static files may be unavailable.` as an indicator that the path is misconfigured.
</Aside>

#### Combining static files with routing

You can combine static file serving with dynamic routing:
Expand Down
Loading