[Rt-commit] rt branch 5.0/websecurecookies-readme created. rt-5.0.4-230-g6a7153f941

[BPS Git Server]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "rt".

The branch, 5.0/websecurecookies-readme has been created
        at  6a7153f941254f622d9f7287818c8ade2ce4dfb2 (commit)

- Log -----------------------------------------------------------------
commit 6a7153f941254f622d9f7287818c8ade2ce4dfb2
Author: Jim Brandt <jbrandt at bestpractical.com>
Date:   Mon Oct 2 09:35:45 2023 -0400

    Document WebSecureCookies in README
    
    Make this easier to find for users installing for the
    first time.

diff --git a/README b/README
index 6a80fce0cd..95f4b96db1 100644
--- a/README
+++ b/README
@@ -58,6 +58,21 @@ o   An external HTML converter
         Installing an external utility to convert HTML can improve performance.
         See the $HTMLFormatter configuration option for details.
 
+o   An SSL certificate for your web server
+
+        For production use, we recommend getting an SSL certificate for your
+        web server. You can get them free from Let's Encrypt (https://letsencrypt.org/)
+        or even create your own self-signed certificate.
+
+        If you are testing and want to run without a cert, add this to your
+        etc/RT_SiteConfig.pm file:
+
+            Set( $WebSecureCookies, 0 );
+
+        Without this setting, your browser won't trust RT's cookies and you won't
+        be able to log in. See the documentation for more information.
+        (https://docs.bestpractical.com/rt/latest/RT_Config.html#WebSecureCookies)
+
 GENERAL INSTALLATION
 --------------------
 

-----------------------------------------------------------------------


hooks/post-receive
-- 
rt