linkding/docs/troubleshooting.md
Sascha Ißbrücker 1c3651e91d
Add setting and documentation for fixing CSRF errors (#349)
* Add documentation and setting for solving CSRF errors

* Improve proxy setup docs

* Link to reverse proxy documentation

* Fix link
2022-10-05 10:01:44 +02:00

1.3 KiB

Troubleshooting

Login fails with 403 CSRF verfication failed

This can be the case when using a reverse proxy that rewrites the Host header, such as Nginx. Since linkding version 1.15, the application includes a CSRF check that verifies that the Origin request header matches the Host header. If the Host header is modified by the reverse proxy then this check fails.

To fix this, check the reverse proxy setup documentation on how to configure header forwarding for your proxy server, or alternatively configure the LD_CSRF_TRUSTED_ORIGINS option to the URL from which you are accessing your linkding instance.

Import fails with 502 Bad Gateway

The default timeout for requests is 60 seconds, after which the application server will cancel the request and return the above error. Depending on the system that the application runs on, and the number of bookmarks that need to be imported, the import may take longer than the default 60 seconds.

To increase the timeout you can configure the LD_REQUEST_TIMEOUT option.

Note that any proxy servers that you are running in front of linkding may have their own timeout settings, which are not affected by the variable.