From 1932906f5586f29e582a0625debdea8e5a79ed72 Mon Sep 17 00:00:00 2001 From: Federico Dossena Date: Wed, 31 Jul 2024 09:05:24 +0200 Subject: [PATCH] Updated README.md --- README.md | 15 ++++++--------- doc_docker.md | 12 ++++++------ docker/ui.php | 4 +++- 3 files changed, 15 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 6b0ca5c72..611ed4d61 100755 --- a/README.md +++ b/README.md @@ -33,14 +33,11 @@ Works with mobile versions too. * A fast! internet connection ## Installation -Assuming you have PHP installed, the installation steps are quite simple. -I set this up on a QNAP. -For this example, I am using a folder called **speedtest** in my web share area. - -1. Choose one of the example-xxx.html files in `examples` folder as your index.html if the default index.html does not fit. -2. Add: speedtest.js, speedtest_worker.js, and favicon.ico to your speedtest folder. -3. Download all of the backend folder into speedtest/backend. -4. Download all of the results folder into speedtest/results. +Assuming you have PHP and a web server installed, the installation steps are quite simple. + +1. Download the source code and extract it +2. Copy the following files to your web server's shared folder (ie. /var/www/html/speedtest for Apache): index.html, speedtest.js, speedtest_worker.js, favicon.ico and the backend folder +4. Optionally, copy the results folder too, and set up the database using the config file in it. 5. Be sure your permissions allow execute (755). 6. Visit YOURSITE/speedtest/index.html and voila! @@ -71,7 +68,7 @@ A partial Node.js implementation is available in the `node` branch, developed by [Donate with PayPal](https://www.paypal.me/sineisochronic) ## License -Copyright (C) 2016-2022 Federico Dossena +Copyright (C) 2016-2024 Federico Dossena This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by diff --git a/doc_docker.md b/doc_docker.md index 358fb9f8f..83397efc5 100755 --- a/doc_docker.md +++ b/doc_docker.md @@ -49,9 +49,9 @@ Here's a list of additional environment variables available in this mode: * __`REDACT_IP_ADDRESSES`__: When set to true with telemetry enabled, IP addresses and hostnames are redacted from the collected telemetry, for better privacy. Default value: `false` * __`PASSWORD`__: Password to access the stats page. If not set, stats page will not allow accesses. * __`EMAIL`__: Email address for GDPR requests. Must be specified when telemetry is enabled. -* __`IPINFO_APIKEY`__: API key for ipinfo.io. Optional, but required if you expect to serve a large number of tests -* __`DISABLE_IPINFO`__: If set to true, ISP info and distance will not be fetched from ipinfo.io. Default: value: `false` -* __`DISTANCE`__: When `DISABLE_IPINFO` is set to false, this specifies how the distance from the server is measured. Can be either `km` for kilometers, `mi` for miles, or an empty string to disable distance measurement. Default value: `km` +* __`DISABLE_IPINFO`__: If set to true, ISP info and distance will not be fetched from either ipinfo.io or the offline database. Default: value: `false` +* __`IPINFO_APIKEY`__: API key for ipinfo.io. Optional, but required if you want to use the full ipinfo.io APIs (required for distance measurement) +* __`DISTANCE`__: When `DISABLE_IPINFO` is set to false, this specifies how the distance from the server is measured. Can be either `km` for kilometers, `mi` for miles, or an empty string to disable distance measurement. Requires an ipinfo.io API key Default value: `km` * __`WEBPORT`__: Allows choosing a custom port for the included web server. Default value: `80`. Note that you will have to expose it through docker with the -p argument If telemetry is enabled, a stats page will be available at `http://your.server/results/stats.php`, but a password must be specified. @@ -85,7 +85,7 @@ In backend mode, LibreSpeed provides only a test point with no UI. To do this, s The following backend files can be accessed on port 80: `garbage.php`, `empty.php`, `getIP.php` Here's a list of additional environment variables available in this mode: -* __`IPINFO_APIKEY`__: API key for ipinfo.io. Optional, but required if you expect to serve a large number of tests +* __`IPINFO_APIKEY`__: API key for ipinfo.io. Optional, but required if you want to use the full ipinfo.io APIs (required for distance measurement). If no API key is provided, the offline database will be used instead. ###### Example: This command starts LibreSpeed in backend mode, with the default settings, on port 80: @@ -130,8 +130,8 @@ Here's a list of additional environment variables available in this mode: * __`REDACT_IP_ADDRESSES`__: When set to true with telemetry enabled, IP addresses and hostnames are redacted from the collected telemetry, for better privacy. Default value: `false` * __`PASSWORD`__: Password to access the stats page. If not set, stats page will not allow accesses. * __`EMAIL`__: Email address for GDPR requests. Must be specified when telemetry is enabled. -* __`DISABLE_IPINFO`__: If set to true, ISP info and distance will not be fetched from ipinfo.io. Default: value: `false` -* __`DISTANCE`__: When `DISABLE_IPINFO` is set to false, this specifies how the distance from the server is measured. Can be either `km` for kilometers, `mi` for miles, or an empty string to disable distance measurement. Default value: `km` +* __`DISABLE_IPINFO`__: If set to true, ISP info and distance will not be fetched from the backend server. Default: value: `false` +* __`DISTANCE`__: When `DISABLE_IPINFO` is set to false, this specifies how the distance from the server is measured. Can be either `km` for kilometers, `mi` for miles, or an empty string to disable distance measurement. Requires an ipinfo.io API Key on the backend server. Default value: `km` * __`WEBPORT`__: Allows choosing a custom port for the included web server. Default value: `80` ###### Example diff --git a/docker/ui.php b/docker/ui.php index 70e85f143..c38763816 100755 --- a/docker/ui.php +++ b/docker/ui.php @@ -9,7 +9,9 @@ function I(i){return document.getElementById(i);} //LIST OF TEST SERVERS. See documentation for details if needed - + var SPEEDTEST_SERVERS=[]; var SPEEDTEST_SERVERS= ;