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
|
||||
|
||||

|
||||
|
||||
[](https://github.com/airlabspl/uptimemonitor/actions/workflows/go.yml)
|
||||
|
||||
[uptimemonitor.dev](https://uptimemonitor.dev)
|
||||
|
||||
© 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