taler-dashboard/README.md

66 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

2023-12-27 03:16:48 +01:00
# taler-dashboard
A dashboard for the GNU Taler project, giving an overview about the state of the
development.
This is **alpha** software.
It is written in go and compiles into a standalone program with all templates as embedded
components.
## Compilation
2023-12-27 03:18:26 +01:00
To compile, you need the latest version of [the go programming language](https://go.dev)
2023-12-27 03:16:48 +01:00
Then, simple download the code from this repository and compile it:
```
git clone https://git.kesim.org/taler/taler-dashboard
cd taler-dashboard
go build
```
## Mantis API-Token
You need an API-token to be able to access the REST-API of https://bugs.taler.net.
The token can be provided via the environment variable `MANTIS_API_TOKEN` or at
the commandline.
## Execution
```
2023-12-27 13:21:13 +01:00
Usage of taler-dashboard:
-fr duration
update frequency (default 1m0s)
2023-12-27 03:16:48 +01:00
-min string
minimum version we care for (default "0.9.3")
-num int
2023-12-27 13:21:13 +01:00
number of issues to retrieve at once (default 250)
2023-12-27 03:16:48 +01:00
-port string
[ip]:port to serve (default ":8080")
2023-12-27 13:21:13 +01:00
-project int
project id to use (default 23)
2023-12-27 03:16:48 +01:00
-token string
API-Token (default "")
-url string
2023-12-27 13:21:13 +01:00
URL to the issues (default "https://bugs.gnunet.org/api/rest")
2023-12-27 03:16:48 +01:00
```
**Note**: We assume that this service runs behind a reverse-proxy which deals
and terminates TLS.
2023-12-27 03:46:20 +01:00
## License
taler-dashboard is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.
taler-dashboard is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You can receive a copy of the GNU General Public License from
<https://www.gnu.org/licenses/>.