# DockerComposeAspireDashboardResourceBuilderExtensions Methods

- Package: [Aspire.Hosting.Docker](/reference/api/csharp/aspire.hosting.docker.md)
- Type: [DockerComposeAspireDashboardResourceBuilderExtensions](/reference/api/csharp/aspire.hosting.docker/dockercomposeaspiredashboardresourcebuilderextensions.md)
- Kind: `Methods`
- Members: `2`

Provides extension methods for creating Aspire Dashboard resources in the application model.

## WithForwardedHeaders(IResourceBuilder<DockerComposeAspireDashboardResource>, bool)

- Name: `WithForwardedHeaders(IResourceBuilder<DockerComposeAspireDashboardResource>, bool)`
- Modifiers: `extension`
- Returns: `IResourceBuilder<DockerComposeAspireDashboardResource>`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Docker/DockerComposeAspireDashboardResourceBuilderExtensions.cs#L83-L85)

Configures whether forwarded headers processing is enabled for the Aspire dashboard container.

```csharp
public static class DockerComposeAspireDashboardResourceBuilderExtensions
{
    public static IResourceBuilder<DockerComposeAspireDashboardResource> WithForwardedHeaders(
        this IResourceBuilder<DockerComposeAspireDashboardResource> builder,
        bool enabled = true)
    {
        // ...
    }
}
```

## Parameters

- `builder` (`IResourceBuilder<DockerComposeAspireDashboardResource>`)
  The `ApplicationModel.IResourceBuilder`1` instance.
- `enabled` (`bool`) `optional`
  True to enable forwarded headers ( `ASPIRE_DASHBOARD_FORWARDEDHEADERS_ENABLED=true`), false to disable it (sets the value to `false`).

## Returns

`IResourceBuilder<DockerComposeAspireDashboardResource>` -- The same `ApplicationModel.IResourceBuilder`1` to allow chaining.

## Remarks

This sets the `ASPIRE_DASHBOARD_FORWARDEDHEADERS_ENABLED` environment variable inside the dashboard container. When enabled, the dashboard will process `X-Forwarded-Host` and `X-Forwarded-Proto` headers which is required when the dashboard is accessed through a reverse proxy or load balancer.

## ATS metadata

### ATS export

- Available to Polyglot AppHosts through the Aspire Type System.

## WithHostPort(IResourceBuilder<DockerComposeAspireDashboardResource>, int?)

- Name: `WithHostPort(IResourceBuilder<DockerComposeAspireDashboardResource>, int?)`
- Modifiers: `extension`
- Returns: `IResourceBuilder<DockerComposeAspireDashboardResource>`
- Source: [GitHub](https://github.com/microsoft/aspire/blob/5bd693ae1897dee5e2ce71c2cc08879c1c7eff51/src/Aspire.Hosting.Docker/DockerComposeAspireDashboardResourceBuilderExtensions.cs#L60-L64)

Configures the port used to access the Aspire Dashboard from a browser.

```csharp
public static class DockerComposeAspireDashboardResourceBuilderExtensions
{
    public static IResourceBuilder<DockerComposeAspireDashboardResource> WithHostPort(
        this IResourceBuilder<DockerComposeAspireDashboardResource> builder,
        int? port = null)
    {
        // ...
    }
}
```

## Parameters

- `builder` (`IResourceBuilder<DockerComposeAspireDashboardResource>`)
  The `ApplicationModel.IResourceBuilder`1` instance to configure.
- `port` (`int?`) `optional`
  The port to bind on the host. If non-null, the dashboard will be exposed on the host. If `null`, the dashboard will not be exposed on the host but will only be reachable within the container network.

## Returns

`IResourceBuilder<DockerComposeAspireDashboardResource>` -- The `ApplicationModel.IResourceBuilder`1` instance for chaining.

## ATS metadata

### ATS export

- Available to Polyglot AppHosts through the Aspire Type System.