Skip to content

Commit 5ddc4fd

Browse files
committed
Docker: Fix timezone issues with TZ env variable and /etc/local volume mapping
Changed the docs for docker configuration, introducing the TZ env variable and the /etc/localtime volume mapping. This solves a lot of issues that are still being opened by users, reporting wrong cron schedules and timestamps in testing records, etc.
1 parent e17a373 commit 5ddc4fd

File tree

1 file changed

+30
-12
lines changed

1 file changed

+30
-12
lines changed

getting-started/installation.md

Lines changed: 30 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,12 @@ In case you want to make sure that your ssl certs are kept between stops and sta
2727
to make it persistent
2828
{% endhint %}
2929

30+
{% hint style="info" %}
31+
In order to make sure timestamps in the UI and logs are correct, make sure to configure the TZ env variable and also
32+
the /etc/localtime volume mapping, as per the examples below. Replace the geo location of TZ with your geo location.
33+
{% endhint %}
34+
35+
3036
{% tabs %}
3137
{% tab title="Docker (Sqlite)" %}
3238
```bash
@@ -35,6 +41,8 @@ docker run -d --name speedtest-tracker --restart unless-stopped \
3541
-p 8443:443 \
3642
-e PUID=1000 \
3743
-e PGID=1000 \
44+
-e TZ=America/Chicago \
45+
-v /etc/localtime:/etc/localtime:ro \
3846
-v /path/to/directory:/config \
3947
-v /path/to/directory/web:/etc/ssl/web \
4048
ghcr.io/alexjustesen/speedtest-tracker:latest
@@ -48,12 +56,14 @@ docker run -d --name speedtest-tracker --restart unless-stopped \
4856
-p 8443:443 \
4957
-e PUID=1000 \
5058
-e PGID=1000 \
51-
-e "DB_CONNECTION=mysql" \
52-
-e "DB_HOST=" \
53-
-e "DB_PORT=3306" \
54-
-e "DB_DATABASE=speedtest_tracker" \
55-
-e "DB_USERNAME=" \
56-
-e "DB_PASSWORD=" \
59+
-e TZ=America/Chicago \
60+
-e DB_CONNECTION=mysql \
61+
-e DB_HOST= \
62+
-e DB_PORT=3306 \
63+
-e DB_DATABASE=speedtest_tracker \
64+
-e DB_USERNAME= \
65+
-e DB_PASSWORD= \
66+
-v /etc/localtime:/etc/localtime:ro \
5767
-v /path/to/directory:/config \
5868
-v /path/to/directory/web:/etc/ssl/web \
5969
ghcr.io/alexjustesen/speedtest-tracker:latest
@@ -67,12 +77,14 @@ docker run -d --name speedtest-tracker --restart unless-stopped \
6777
-p 8443:443 \
6878
-e PUID=1000 \
6979
-e PGID=1000 \
70-
-e "DB_CONNECTION=pgsql" \
71-
-e "DB_HOST=" \
72-
-e "DB_PORT=5432" \
73-
-e "DB_DATABASE=speedtest_tracker" \
74-
-e "DB_USERNAME=" \
75-
-e "DB_PASSWORD=" \
80+
-e DB_CONNECTION=pgsql \
81+
-e DB_HOST= \
82+
-e DB_PORT=5432 \
83+
-e DB_DATABASE=speedtest_tracker \
84+
-e DB_USERNAME= \
85+
-e DB_PASSWORD= \
86+
-e TZ=America/Chicago \
87+
-v /etc/localtime:/etc/localtime:ro \
7688
-v /path/to/directory:/config \
7789
-v /path/to/directory/web:/etc/ssl/web \
7890
ghcr.io/alexjustesen/speedtest-tracker:latest
@@ -95,7 +107,9 @@ services:
95107
environment:
96108
- PUID=1000
97109
- PGID=1000
110+
- TZ=America/Chicago
98111
volumes:
112+
- '/etc/localtime:/etc/localtime:ro'
99113
- '/path/to/directory:/config'
100114
- '/path/to/directory/web:/etc/ssl/web'
101115
image: 'ghcr.io/alexjustesen/speedtest-tracker:latest'
@@ -121,7 +135,9 @@ services:
121135
- DB_DATABASE=speedtest_tracker
122136
- DB_USERNAME=speedy
123137
- DB_PASSWORD=password
138+
- TZ=America/Chicago
124139
volumes:
140+
- '/etc/localtime:/etc/localtime:ro'
125141
- '/path/to/directory:/config'
126142
- '/path/to/directory/web:/etc/ssl/web'
127143
image: 'ghcr.io/alexjustesen/speedtest-tracker:latest'
@@ -161,7 +177,9 @@ services:
161177
- DB_DATABASE=speedtest_tracker
162178
- DB_USERNAME=speedy
163179
- DB_PASSWORD=password
180+
- TZ=America/Chicago
164181
volumes:
182+
- '/etc/localtime:/etc/localtime:ro'
165183
- '/path/to/directory:/config'
166184
- '/path/to/directory/web:/etc/ssl/web'
167185
image: 'ghcr.io/alexjustesen/speedtest-tracker:latest'

0 commit comments

Comments
 (0)