uptimerunner/readme.md

@uptime.link/uptimerunner

Deno-powered uptime.link runner agent. It connects to an uptime.link instance, fetches assigned checks, executes them from the runner's network location, and reports results back.

Install

curl -sSL https://code.foss.global/uptime.link/uptimerunner/raw/branch/main/install.sh | sudo bash

Configure

sudo uptimerunner config write \
  --url https://uptime.link \
  --runner-id edge-1 \
  --token <runner-token>

Run

uptimerunner run

For systemd:

sudo uptimerunner service install
sudo uptimerunner service start

Runner Protocol

The runner polls:

GET /api/runner/v1/checks?runnerId=<runnerId>

The uptime.link instance returns:

{
  "checks": [
    {
      "id": "api-health",
      "type": "http",
      "url": "https://api.example.com/health",
      "expectedStatusCodes": [200],
      "expectedBodyIncludes": "ok"
    }
  ]
}

The runner reports:

POST /api/runner/v1/results

Supported check types:

• http
• tcp
• assumption

Development

deno task check
deno task test
deno task compile