added proper notes and block highlighting (#69)

Frank Elsinga 2023-12-03 19:14:43 +01:00 committed by GitHub
parent a8e0792aca
commit daea415e11
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
7 changed files with 20 additions and 16 deletions

@ -39,17 +39,17 @@ Authentication is done by passing the API key in the `Authorization`
header. For example, here is a request made with curl to the `metrics`
endpoint.
```
```bash
curl -u":<key>" uptime.kuma/metrics
```
Note, the `:` is required before the key as basic authentication
requires a username and password separated by a `:`, however we don't
make use of the username field.
> [!NOTE]
> `:` is required before the key, because basic authentication requires a username and password separated by a `:`.
> We don't make use of the username field.
Here is an example config for Prometheus:
```
```yml
- job_name: 'uptime'
scrape_interval: 30s
scheme: http
@ -59,4 +59,5 @@ Here is an example config for Prometheus:
password: <api key>
```
Note: we don't need to set a username field as it is not used.
> [!NOTE]
> Seting the username field is not nessesary, as it is unused.

@ -45,20 +45,20 @@ start_post() {
Set the script to executable.
```sh
```bash
sudo chmod 755 /etc/init.d/uptime-kuma
```
Create a user and group `uptime-kuma:uptime-kuma` for the service.
```sh
```bash
sudo addgroup -S uptime-kuma
sudo adduser -S -D -h /var/lib/uptime-kuma -s /sbin/nologin -G uptime-kuma -g uptime-kuma uptime-kuma
```
Start the service and add it to default runlevel if preferred.
```sh
```bash
sudo rc-service uptime-kuma start
sudo rc-update add uptime-kuma
```

@ -16,7 +16,7 @@ Labels to filter by include:
Put the following into your Prometheus config:
```
```yml
- job_name: 'uptime'
scrape_interval: 30s
scheme: http

@ -1,6 +1,6 @@
## With Docker
```
```bash
docker exec -it <container name> bash
npm run reset-password
```

@ -166,7 +166,7 @@ Link to https-portal Websocket under [Advanced Usage](https://github.com/SteveLT
Example docker-compose.yml file using Https-Portal:
```
```yml
version: '3.3'
services:
@ -224,7 +224,7 @@ docker run -d --restart=always -p 127.0.0.1:3002:3001 -v uptime-kuma:/app/data -
7. Click `Create` -> `Websockets`, this automatically fills in the required headers for websockets.
# Traefik
```
```yml
labels:
- "traefik.enable=true"
- "traefik.http.routers.uptime-kuma.rule=Host(`YourOwnHostname`)"

@ -17,13 +17,15 @@ Restart=on-failure
WantedBy=multi-user.target
```
Note: This unit file assumes that you are running the software as a separate 'uptime' user. If you have node/npm installed in a different path, you will need to alter the ExecStart line to match this.
> [!NOTE]
> This unit file assumes that you are running the software as a separate 'uptime' user.
> If you have node/npm installed in a different path, you will need to alter the ExecStart line to match this.
This unit file may be installed to /etc/systemd/system/uptime-kuma.service (Or whatever service name you'd prefer)
Once installed, issue the following commands to reload systemd unit files, enable it to start on boot, and start it immediately:
```sh
```bash
systemctl daemon-reload
systemctl enable --now uptime-kuma
```

@ -115,7 +115,8 @@ https://github.com/louislam/uptime-kuma/wiki/Reverse-Proxy
### ☸️ OpenShift 4 and Kubernetes Helm 3 Chart (Unofficial)
> Note: This Chart relies on a repackaged OCI Container Image, which lets *uptime-kuma* run as **non-root** user. \
> [!NOTE]
> This Chart relies on a repackaged OCI Container Image, which lets *uptime-kuma* run as **non-root** user.
> The entire repackage process is automated via GitHub Actions and renovate-bot keeps everything up to date. (feel free to audit it yourself)
The Containerfile used to rebundle *uptime-kuma*: [rootless Containerfile](https://github.com/k3rnelpan1c-dev/uptime-kuma-helm/blob/main/container/Containerfile)