From 50daf8858b10bca0d0e095a4e8f8d42194dad8cd Mon Sep 17 00:00:00 2001
From: Viktor van Wijk <viktorvanwijk@hotmail.com>
Date: Thu, 12 Dec 2024 12:45:10 +0100
Subject: [PATCH] :memo: [#4907] Improve developer installation documentation

Add notes about Redis server, Celery worker and CORS_ALLOWED_ORIGINS variable in .env
---
 INSTALL.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/INSTALL.rst b/INSTALL.rst
index b4a871f8c6..fbd52c59d6 100644
--- a/INSTALL.rst
+++ b/INSTALL.rst
@@ -116,6 +116,13 @@ development machine.
 ``.env`` file or ``src/openforms/conf/local.py``. You can base this file on the
 example file included in the same directory.
 
+For functional testing, if you run into trouble submitting forms or saving forms in the admin,
+ensure the following is valid:
+
+* `Redis server is running <https://redis.io/docs/latest/operate/oss_and_stack/install/install-redis/>`_
+* `Celery worker is running <https://open-forms.readthedocs.io/en/latest/developers/installation.html#running-background-and-periodic-tasks>`_
+* Uncomment the ``CORS_ALLOWED_ORIGINS`` variable in your local ``.env`` file and add the address from step 8 to this list.
+
 
 Building and running the frontend code
 --------------------------------------