Skip to content

Commit 769db0a

Browse files
committed
Add new vars to readme
1 parent e22556d commit 769db0a

File tree

2 files changed

+16
-0
lines changed

2 files changed

+16
-0
lines changed

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -79,11 +79,15 @@ services:
7979
- TZ=Etc/UTC
8080
- APP_KEY=
8181
- DB_CONNECTION=sqlite
82+
- SPEEDTEST_SCHEDULE=
83+
- SPEEDTEST_SERVERS=
8284
- DB_HOST= #optional
8385
- DB_PORT= #optional
8486
- DB_DATABASE= #optional
8587
- DB_USERNAME= #optional
8688
- DB_PASSWORD= #optional
89+
- DISPLAY_TIMEZONE=Etc/UTC #optional
90+
- PRUNE_RESULTS_OLDER_THAN=0 #optional
8791
volumes:
8892
- /path/to/data:/config
8993
ports:
@@ -101,11 +105,15 @@ docker run -d \
101105
-e TZ=Etc/UTC \
102106
-e APP_KEY= \
103107
-e DB_CONNECTION=sqlite \
108+
-e SPEEDTEST_SCHEDULE= \
109+
-e SPEEDTEST_SERVERS= \
104110
-e DB_HOST= `#optional` \
105111
-e DB_PORT= `#optional` \
106112
-e DB_DATABASE= `#optional` \
107113
-e DB_USERNAME= `#optional` \
108114
-e DB_PASSWORD= `#optional` \
115+
-e DISPLAY_TIMEZONE=Etc/UTC `#optional` \
116+
-e PRUNE_RESULTS_OLDER_THAN=0 `#optional` \
109117
-p 80:80 \
110118
-v /path/to/data:/config \
111119
--restart unless-stopped \
@@ -124,11 +132,15 @@ Containers are configured using parameters passed at runtime (such as those abov
124132
| `-e TZ=Etc/UTC` | specify a timezone to use, see this [list](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List). |
125133
| `-e APP_KEY=` | App key used for encrypting stored data. You can generate a key at [https://speedtest-tracker.dev](https://speedtest-tracker.dev) |
126134
| `-e DB_CONNECTION=sqlite` | Set the database type to use. `sqlite`, `pgsql`, or `mysql` |
135+
| `-e SPEEDTEST_SCHEDULE=` | Set the test schedule in cron format. e.g. `0 */6 * * *` |
136+
| `-e SPEEDTEST_SERVERS=` | A comma-separated list of server IDs to test against. Run `docker exec speedtest-tracker php /app/www/artisan app:ookla-list-servers` to get a list of nearby servers. |
127137
| `-e DB_HOST=` | Database hostname (postgres/mysql). |
128138
| `-e DB_PORT=` | Database port (postgres/mysql). |
129139
| `-e DB_DATABASE=` | Database name (postgres/mysql). |
130140
| `-e DB_USERNAME=` | Database username (postgres/mysql). |
131141
| `-e DB_PASSWORD=` | Database password (postgres/mysql). |
142+
| `-e DISPLAY_TIMEZONE=Etc/UTC` | Timezone for the UI. |
143+
| `-e PRUNE_RESULTS_OLDER_THAN=0` | Days to keep test results. |
132144
| `-v /config` | Contains speedtest-tracker config and database, if using sqlite. |
133145

134146
## Environment variables from files (Docker secrets)

readme-vars.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,8 @@ param_usage_include_env: true
2222
param_env_vars:
2323
- { env_var: "APP_KEY", env_value: "", desc: "App key used for encrypting stored data. You can generate a key at [https://speedtest-tracker.dev](https://speedtest-tracker.dev)" }
2424
- { env_var: "DB_CONNECTION", env_value: "sqlite", desc: "Set the database type to use. `sqlite`, `pgsql`, or `mysql`" }
25+
- { env_var: "SPEEDTEST_SCHEDULE", env_value: "", desc: "Set the test schedule in cron format. e.g. `0 */6 * * *`" }
26+
- { env_var: "SPEEDTEST_SERVERS", env_value: "", desc: "A comma-separated list of server IDs to test against. Run `docker exec speedtest-tracker php /app/www/artisan app:ookla-list-servers` to get a list of nearby servers." }
2527
param_usage_include_vols: true
2628
param_volumes:
2729
- { vol_path: "/config", vol_host_path: "/path/to/data", desc: "Contains speedtest-tracker config and database, if using sqlite." }
@@ -36,6 +38,8 @@ opt_param_env_vars:
3638
- { env_var: "DB_DATABASE", env_value: "", desc: "Database name (postgres/mysql)." }
3739
- { env_var: "DB_USERNAME", env_value: "", desc: "Database username (postgres/mysql)." }
3840
- { env_var: "DB_PASSWORD", env_value: "", desc: "Database password (postgres/mysql)." }
41+
- { env_var: "DISPLAY_TIMEZONE", env_value: "Etc/UTC", desc: "Timezone for the UI." }
42+
- { env_var: "PRUNE_RESULTS_OLDER_THAN", env_value: "0", desc: "Days to keep test results." }
3943

4044
# application setup block
4145
app_setup_block_enabled: true

0 commit comments

Comments
 (0)