Skip to content
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

Jump to bottom

docs: troubleshooting issues with self-signed SSL certs #11126

Merged
merged 6 commits into from
Dec 17, 2022
Merged

docs: troubleshooting issues with self-signed SSL certs #11126

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
ef12abe
Troubleshooting issues with self-signed SSL certs
fc Nov 30, 2022
f0221c6
fix: fix format
fc Nov 30, 2022
307453c
Text updates
fc Dec 3, 2022
b609477
Merge branch 'vitejs:main' into patch-3
fc Dec 10, 2022
1d24698
Update docs/guide/troubleshooting.md
fc Dec 16, 2022
cb596ad
Merge branch 'vitejs:main' into patch-3
fc Dec 16, 2022
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
22 changes: 22 additions & 0 deletions docs/guide/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,6 +51,24 @@ If the above steps don't work, you can try adding `DefaultLimitNOFILE=65536` as

Note that these settings persist but a **restart is required**.

### Network requests stop loading

When using a self-signed SSL certificate, Chrome ignores all caching directives and reloads the content. Vite relies on these caching directives.

To resolve the problem use a trusted SSL cert.

See: [Cache problems](https://helpx.adobe.com/mt/experience-manager/kb/cache-problems-on-chrome-with-SSL-certificate-errors.html), [Chrome issue](https://bugs.chromium.org/p/chromium/issues/detail?id=110649#c8)

#### macOS

You can install a trusted cert via the CLI with this command:

```
security add-trusted-cert -d -r trustRoot -k ~/Library/Keychains/login.keychain-db your-cert.cer
```

Or, by importing it into the Keychain Access app and updating the trust of your cert to "Always Trust."

### 431 Request Header Fields Too Large

When the server / WebSocket server receives a large HTTP header, the request will be dropped and the following warning will be shown.
Expand Down Expand Up @@ -83,6 +101,10 @@ If HMR is not handled by Vite or a plugin, a full reload will happen.

Also if there is a dependency loop, a full reload will happen. To solve this, try removing the loop.

### High number of HMR updates in console

This can be caused by a circular dependency. To solve this, try breaking the loop.

## Build

### Built file does not work because of CORS error
Expand Down