Skip to content

[7.x] "astro dev --background" fails on Windows #17146

Description

@Smart-Ace-Designs

Astro Info

Astro                    v7.0.0
Vite                     v8.0.16
Node                     v24.17.0
System                   Windows (x64)
Package Manager          npm
Output                   static
Adapter                  none
Integrations             none

If this issue only occurs in one browser, which browser is a problem?

n/a

Describe the Bug

On Windows run (PowerShell, CMD, or Git Bash):
npx astro dev --background

Fails with:
"Failed to spawn background dev server process."

On Linux (PowerShell or Bash):
npx astro dev --background

Succeeds with:
Dev server running at http://localhost:4321 (pid nnnn)

What's the expected result?

Windows OS should work as Linux OS does: allowing dev server to spawn as background process. This should be the case for PowerShell, CMD, or Git Bash. I could not find anything in the docs to suggest this is a Linux only option.

If this is a user error, and I am running the command incorrectly or Windows is not supported, please let me know and I will close.
Thank you.

Link to Minimal Reproducible Example

n/a

Participation

  • I am willing to submit a pull request for this issue.

Metadata

Metadata

Assignees

Labels

- P4: importantViolate documented behavior or significantly impacts performance (priority)triage: needs triageIssue needs to be triaged

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions