mirror of
https://github.com/airlabspl/uptimemonitor.git
synced 2025-08-14 12:19:19 +02:00
add docs
This commit is contained in:
80
README.md
80
README.md
@@ -1,7 +1,87 @@
|
|||||||
# UPTIME MONITOR
|
# UPTIME MONITOR
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
[](https://github.com/airlabspl/uptimemonitor/actions/workflows/go.yml)
|
[](https://github.com/airlabspl/uptimemonitor/actions/workflows/go.yml)
|
||||||
|
|
||||||
[uptimemonitor.dev](https://uptimemonitor.dev)
|
[uptimemonitor.dev](https://uptimemonitor.dev)
|
||||||
|
|
||||||
© 2025 AIR Labs
|
© 2025 AIR Labs
|
||||||
|
|
||||||
|
## Yet another uptime monitor?
|
||||||
|
|
||||||
|
Yes, but with following constraints:
|
||||||
|
|
||||||
|
- 100% self-hosted
|
||||||
|
- Single binary when build
|
||||||
|
- 0 configuration
|
||||||
|
- Simple functionality without bloat
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
1. Download the latest release to a Linux VPS (check the
|
||||||
|
[Releases page](https://github.com/airlabspl/uptimemonitor/releases)):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
wget https://github.com/airlabspl/uptimemonitor/releases/download/v0.0.2-alpha/uptimemonitor
|
||||||
|
chmod +x uptimemonitor
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Run it
|
||||||
|
|
||||||
|
```bash
|
||||||
|
./uptimemonitor -addr=":3000"
|
||||||
|
```
|
||||||
|
|
||||||
|
## First run
|
||||||
|
|
||||||
|
When you first run the application you will be asked to create a new account,
|
||||||
|
which you will then use to log in.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
To start monitoring a given url, add the url on a `/new` page. You can specify
|
||||||
|
the HTTP method the check will use (GET, POST, etc.) as well as add custom
|
||||||
|
headers and body to the request.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Incidents
|
||||||
|
|
||||||
|
When the check fails, the incident will be created and will stay open until the
|
||||||
|
upcoming check succeeds. You can dig into the failing request details on a
|
||||||
|
incident page.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Webhooks
|
||||||
|
|
||||||
|
If you want to get notified when an incident happens, you can also configure a
|
||||||
|
webhook notification to a given url of choice (e.g. slack or google chat webhook
|
||||||
|
url). You can use `{{ .Url }}` and `{{ .StatusCode }}` variables inside a body
|
||||||
|
to pass those information to the webhook.
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
## Https
|
||||||
|
|
||||||
|
Because the app uses secure cookies for authentication, it is required to use
|
||||||
|
some reverse proxy with https certificate configured.
|
||||||
|
|
||||||
|
If you want to test the app without secure cookies enabled, provide the
|
||||||
|
`-secure=false` flag.
|
||||||
|
|
||||||
|
## Backups
|
||||||
|
|
||||||
|
This app uses a sqlite database so to backup the data just copy the
|
||||||
|
`uptimemonitor.sqlite*` files to a new location.
|
||||||
|
|
||||||
|
## Pricing
|
||||||
|
|
||||||
|
The app is free to use but if you are using it commercially and can aford a
|
||||||
|
small donation- please use Github Sponsors.
|
||||||
|
|
||||||
|
The donations of $50 a month and above will be featured in a sponsors area
|
||||||
|
inside the application dashboard.
|
||||||
|
BIN
docs/incident.png
Normal file
BIN
docs/incident.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 86 KiB |
BIN
docs/new.png
Normal file
BIN
docs/new.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 72 KiB |
BIN
docs/setup.png
Normal file
BIN
docs/setup.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 42 KiB |
BIN
docs/uptimemonitor.png
Normal file
BIN
docs/uptimemonitor.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 75 KiB |
BIN
docs/webhook.png
Normal file
BIN
docs/webhook.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 45 KiB |
Reference in New Issue
Block a user