mirror of
https://github.com/henrywhitaker3/Speedtest-Tracker.git
synced 2025-12-26 07:13:35 +01:00
60 lines
2.9 KiB
Markdown
60 lines
2.9 KiB
Markdown
# Speedtest Tracker
|
|
|
|
[](https://hub.docker.com/r/henrywhitaker3/speedtest-tracker) [](https://github.com/henrywhitaker3/Speedtest-Tracker/commits) [](https://github.com/henrywhitaker3/Speedtest-Tracker/issues) [](https://github.com/henrywhitaker3/Speedtest-Tracker/commits)  [](https://github.com/henrywhitaker3/Speedtest-Tracker/blob/master/LICENSE)
|
|
|
|
This program runs a speedtest check every hour and graphs the results. The back-end is written in [Laravel](https://laravel.com/) and the front-end uses [React](https://reactjs.org/). It uses the [speedtest-cli](https://github.com/sivel/speedtest-cli) package to get the data and uses [Chart.js](https://www.chartjs.org/) to plot the results.
|
|
|
|
|
|
|
|
## Features
|
|
|
|
- Automatically run a speedtest every hour
|
|
- Graph of previous speedtests going back x days
|
|
- Backup/restore data in JSON format
|
|
- Slack/Discord notifications
|
|
- Organizr integration
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
docker create \
|
|
--name=speedtest \
|
|
-p 8765:80 \
|
|
-v /path/to/data:/config \
|
|
-e SLACK_WEBHOOK=webhook `#optional` \
|
|
--restart unless-stopped \
|
|
henrywhitaker3/speedtest-tracker
|
|
```
|
|
|
|
## Parameters
|
|
|
|
Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
|
|
|
|
| Parameter | Function |
|
|
| :----: | --- |
|
|
| `-p 8765:80` | Exposes the webserver on port 8765 |
|
|
| `-e SLACK_WEBHOOK` | Put a slack webhook here to get slack notifications when a speedtest is run. To use discord webhooks, just append `/slack` to the end of your discord webhook URL |
|
|
| `-v /config` | All the config files reside here. |
|
|
|
|
|
|
## Getting the Image
|
|
|
|
To get the base image, you have 2 options:
|
|
|
|
- Use the pre-built image on dockerhub
|
|
- Build the image yourself
|
|
|
|
### Pre-built Image
|
|
|
|
Run `docker pull henrywhitaker3/speedtest-tracker`
|
|
|
|
### Dockerfile
|
|
|
|
Clone the required files from the github repo [here](https://github.com/henrywhitaker3/Speedtest-Tracker/tree/docker) making sure to use the `docker` branch of the repo.
|
|
|
|
Build the image from the docker file by running (within the cloned git repo):
|
|
|
|
```bash
|
|
docker build . -f Dockerfile --tag=henrywhitaker3/speedtest-tracker:<tag>
|
|
```
|