Skip to content

Commit 664fb7e

Browse files
committed
chore: add readme
1 parent 424f50d commit 664fb7e

2 files changed

Lines changed: 36 additions & 0 deletions

File tree

dashboard/.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# build out
2+
dashboard

dashboard/README.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# Dashboard
2+
3+
A simple server that periodically fetches data from the analytics server API and displays them in a simple dashboard.
4+
5+
## Usage
6+
7+
Build the binary with:
8+
9+
```sh
10+
go build .
11+
```
12+
13+
And run with:
14+
15+
```
16+
./dashboard
17+
```
18+
19+
Then visit <http://localhost:8080> to see the analytics.
20+
21+
> [!NOTE]
22+
> A docker image is also available, check out the example [docker compose](../docker-compose.yml) file.
23+
24+
## Configuration
25+
26+
You can configure the server using environment variables, the following options are supported:
27+
28+
| Name | Type | Description | Default |
29+
| ------------------ | ------ | ------------------------------------------------ | -------------------------- |
30+
| `PORT` | number | The port to run the server on. | `8080` |
31+
| `ADDRESS` | string | The address to bind the server to. | `0.0.0.0` |
32+
| `API_SERVER` | string | The analytics API server URL to fetch data from. | `https://api.tinyauth.app` |
33+
| `PAGE_SIZE` | number | Number of instances to display per page. | `10` |
34+
| `REFRESH_INTERVAL` | number | How often to refresh data from API (in minutes). | `30` |

0 commit comments

Comments
 (0)