diff doc/installation.txt @ 6581:b5fb268b7f04

Docker installation doc improved and switchable debugging Using a Docker container, login was failing with no error or ok message. After a lengthy debugging session on irc with alxjsn assisted by taggnostr realised it was the web setting in config.ini. Install doc for docker now mentions that the web setting must end in /issues/. SHELL_DEBUG environment variable enabled set -xv in startp script.a
author John Rouillard <rouilj@ieee.org>
date Tue, 04 Jan 2022 16:31:04 -0500
parents c55d56ab9ee9
children 24e2eeb2ed9a
line wrap: on
line diff
--- a/doc/installation.txt	Tue Jan 04 10:41:20 2022 -0500
+++ b/doc/installation.txt	Tue Jan 04 16:31:04 2022 -0500
@@ -291,8 +291,12 @@
 you to install a tracker template and prompt you for the database
 type.
 
-Once you have edited and configured ``template/config.ini``, (see
-`Configuring your first tracker`) run another interactive session
+Then you need to configure the tracker by editing
+``template/config.ini``.  Make sure that the tracker web setting ends
+in ``/issues/`` See `Configuring your first tracker` and the top of
+``config.ini`` for other settings.
+
+Once you have configured the tracker, run another interactive session
 with::
 
     docker run --rm -it -p 9017:8080 \
@@ -316,6 +320,10 @@
 where ``c0d5`` is the id prefix for the running container obtained
 from ``docker container ls``.
 
+If you add ``-e SHELL_DEBUG=1`` to the docker command, it sets the
+``SHELL_DEBUG`` environment variable which will enable debugging
+output from the startup script.
+
 Non-Guided Installation
 '''''''''''''''''''''''
 

Roundup Issue Tracker: http://roundup-tracker.org/