HTTP ERROR 404 on Page Reload

[leeshhi]

Describe the bug

Hey i got a issue on my fresh installed vitepress..
I can reload the main page "index" as often i want it works, but as soon i go into a "docs" page "https://example.com/introduction/getting-started" i get a HTTP ERROR 404 on reload everytime ..
does someone know, why ?

Reproduction

as soon i go into a "docs" page "https://example.com/introduction/getting-started" i get a HTTP ERROR 404 on reload everytime ..

Expected behavior

Reload page normal without issues.

System Info

System:
    OS: Linux 6.12 Debian GNU/Linux trixie/sid
    CPU: (2) x64 AMD EPYC 7543 32-Core Processor
    Memory: 3.20 GB / 3.84 GB
    Container: Yes
    Shell: 5.2.37 - /bin/bash
  Binaries:
    Node: 22.13.1 - /usr/bin/node
    npm: 11.0.0 - /usr/bin/npm
    pnpm: 10.0.0 - /usr/bin/pnpm
  npmPackages:
    vitepress: ^1.6.3 => 1.6.3

Additional context

No response

Validations

• Check if you're on the latest VitePress version.
• Follow our Code of Conduct
• Read the docs.
• Check that there isn't already an issue that reports the same bug to avoid creating a duplicate.

[leeshhi]

package.json:

{
  "devDependencies": {
    "vitepress": "^1.6.3"
  },
  "scripts": {
    "docs:dev": "vitepress dev docs --host",
    "docs:build": "vitepress build docs",
    "docs:preview": "vitepress preview docs"
  },
  "dependencies": {
    "medium-zoom": "^1.1.0"
  }
}

[leeshhi]

Update:
Seems to happen on a "dead link" in the page .. when you ignoring deadlinks
Nvm

Update 2:

• seems like if i use "cleanUrls" it wont be able to reload the page..

[brc-dd]

How/where are you deploying your site? VitePress cannot control your server behavior. For cleanUrls you need server to handle non .html routes.

https://vitepress.dev/reference/site-config#cleanurls
https://vitepress.dev/guide/routing#generating-clean-url

[leeshhi]

Yea saw that i fixed it with try_files {path} {path}.html in my caddy config