Skip to content

Commit 0f42750

Browse files
committed
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
1 parent 25b8958 commit 0f42750

File tree

2 files changed

+14
-4
lines changed

2 files changed

+14
-4
lines changed

doc/installation.txt

Lines changed: 10 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -291,8 +291,12 @@ If the tracker directory is empty, the docker container will prompt
291291
you to install a tracker template and prompt you for the database
292292
type.
293293

294-
Once you have edited and configured ``template/config.ini``, (see
295-
`Configuring your first tracker`) run another interactive session
294+
Then you need to configure the tracker by editing
295+
``template/config.ini``. Make sure that the tracker web setting ends
296+
in ``/issues/`` See `Configuring your first tracker` and the top of
297+
``config.ini`` for other settings.
298+
299+
Once you have configured the tracker, run another interactive session
296300
with::
297301

298302
docker run --rm -it -p 9017:8080 \
@@ -316,6 +320,10 @@ can use::
316320
where ``c0d5`` is the id prefix for the running container obtained
317321
from ``docker container ls``.
318322

323+
If you add ``-e SHELL_DEBUG=1`` to the docker command, it sets the
324+
``SHELL_DEBUG`` environment variable which will enable debugging
325+
output from the startup script.
326+
319327
Non-Guided Installation
320328
'''''''''''''''''''''''
321329

scripts/Docker/roundup_start

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@
66

77
# "$@" should be a set of tracker=directory pairs.
88

9-
set -xv
9+
if ! [ -z "$SHELL_DEBUG" ]; then
10+
set -xv
11+
fi
1012

1113
trap exit INT
1214

@@ -22,7 +24,7 @@ for tracker_spec in "$@"; do
2224
# ^ is a tab for use with <<-
2325

2426
# was $tracker_spec in the form of a=b, if not ignore it.
25-
# allows setting CMD to -p 9090 issue=tracker for example.
27+
# allows setting CMD to -i index_template issue=tracker for example.
2628
if [ -z "$directory" ]; then continue; fi
2729

2830
# something is specified or built wrong. Don't start.

0 commit comments

Comments
 (0)