diff --git a/docs/docs/faq.md b/docs/docs/faq.md index dd35b8083d..6f7b7bce3a 100644 --- a/docs/docs/faq.md +++ b/docs/docs/faq.md @@ -58,6 +58,13 @@ If you see this error, it means that the `INVENTREE_SITE_URL` environment variab If you have successfully started the InvenTree server, but are experiencing issues logging in, it may be due to the security interactions between your web browser and the server. While the default configuration should work for most users, if you do experience login issues, ensure that your [server access settings](./start/config.md#server-access) are correctly configured. +### Session Cookies + +The [0.17.0 release](https://github.com/inventree/InvenTree/releases/tag/0.17.0) included [a change to the way that session cookies were handled](https://github.com/inventree/InvenTree/pull/8269). This change may cause login issues for existing InvenTree installs which are upgraded from an older version. System administrators should refer to the [server access settings](./start/config.md#server-access) and ensure that the following settings are correctly configured: + +- **INVENTREE_SESSION_COOKIE_SECURE**: `False` +- **INVENTREE_COOKIE_SAMESITE**: `False` + ## Update Issues Sometimes, users may encounter unexpected error messages when updating their InvenTree installation to a newer version.