From 02967a5b1d0ae40170d12a7b26e0779f3b578715 Mon Sep 17 00:00:00 2001
From: Oliver <oliver.henry.walters@gmail.com>
Date: Tue, 31 Dec 2024 20:36:27 +1100
Subject: [PATCH] Reintroduce FAQ entry (#8812)

---
 docs/docs/faq.md | 7 +++++++
 1 file changed, 7 insertions(+)

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.