Skip to content

[docs] Document automatic HTTPS certificate generation for non-.NET AppHosts#1063

Closed
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/aspire-17454-https-cert-non-dotnet-apphost-3a00c112466baba4
Closed

[docs] Document automatic HTTPS certificate generation for non-.NET AppHosts#1063
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/aspire-17454-https-cert-non-dotnet-apphost-3a00c112466baba4

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#17454 (@JamesNK).

Targeting release/13.4 based on the source PR milestone 13.4.

Why this PR is needed

PR microsoft/aspire#17454 fixes a failure for non-.NET AppHosts (such as TypeScript AppHosts) where the dashboard resource service defaults to HTTPS but no HTTPS development certificate exists. Unlike .NET projects, TypeScript AppHosts don't trigger the dotnet first-run experience that normally generates the dev cert.

The fix adds automatic HTTPS development certificate generation in the Aspire CLI when running a non-.NET AppHost in non-interactive mode, with an opt-out via ASPIRE_CLI_GENERATE_HTTPS_CERTIFICATE=false.

What was changed

Updated src/frontend/src/content/docs/app-host/certificate-configuration.mdx to document:

  • The automatic HTTPS certificate generation behavior for non-.NET AppHosts when running aspire run
  • The ASPIRE_CLI_GENERATE_HTTPS_CERTIFICATE environment variable opt-out with example commands for bash and PowerShell

Files modified

  • src/frontend/src/content/docs/app-host/certificate-configuration.mdx — updated existing page

Generated by PR Documentation Check for issue #17454 · ● 65.2M ·

…pHosts

Documents the new behavior introduced in microsoft/aspire#17454:
- When aspire run starts a non-.NET AppHost (e.g., TypeScript) in
  non-interactive mode and no HTTPS dev certificate exists, the CLI
  now automatically generates one.
- The ASPIRE_CLI_GENERATE_HTTPS_CERTIFICATE environment variable can
  be set to 'false' to opt out of automatic certificate generation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant