docs: document missing headers problem

kevin-dp commented 1 week ago

This PR documents the problem when Electric client complains about missing headers and how to solve it. It was requested in https://github.com/electric-sql/electric/pull/1957 and that PR will need to be updated such that the error message refers to the section we add to the troubleshooting guide in this PR. Once this PR has been approved and the title of the subsection won't change we can add the link in the other PR.

TODO:

Potentially add a code snippet showing proxy configuration. Although it seems that Caddy forwards the headers automatically unless you explicitly remove headers. So not sure if a snippet is needed, @KyleAMathews ?

netlify[bot] commented 1 week ago

Deploy Preview for electric-next ready!

Name	Link
Latest commit
Latest deploy log	https://app.netlify.com/sites/electric-next/deploys/673ef6ed3f71d94efb0565d0
Deploy Preview	https://deploy-preview-1976--electric-next.netlify.app
Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

KyleAMathews commented 1 week ago

Yeah good call — just proxying OPTION to Electric is a good solution for many people. That for sure works.

electric-sql / electric