Quick Start

This guide takes you from zero to a working dashboard with live data. Estimated time: 5 minutes.

Step 1: Sign up

Go to numbrs.lol and create an account. Email and password — that’s it.

If you’d rather self-host, follow the Self-Hosting guide first, then come back here.

Step 2: Add your first uptime monitor

This is the fastest way to get data showing up — no scripts needed.

1. Click Uptime Monitoring in the sidebar
2. Click Add Monitor
3. Enter any URL you want to watch (your website, an API, anything HTTP/HTTPS)
4. Name it something descriptive
5. Leave the check interval at 5 minutes for now
6. Click Save

numbrs will ping the URL on schedule and track availability and response time. You’ll see a status indicator and response time chart populate over the next few minutes.

Step 3: Push your first custom metric

You’ll need your API key: go to Settings → API Keys and copy it.

Then run this in your terminal:

curl -X POST https://numbrs.lol/api/ingest \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"metric": "my.first.metric", "value": 42}'

Replace YOUR_API_KEY with your actual key. You should get a 200 OK back.

That’s it. The metric is now in your database. To send more values, run the command again with a different value. Over time, this builds up a time series you can chart.

See Custom Metrics for the full API reference and real-world examples.

Step 4: Create a dashboard

1. Click Dashboards in the sidebar
2. Click New Dashboard
3. Give it a name — “My First Dashboard” is fine
4. Click Add Panel
5. From the metric dropdown, select my.first.metric (the one you just pushed)
6. Choose Stat as the panel type to show the current value
7. Click Save

Your panel is now on the dashboard. Run the curl command a few more times with different values, then switch the panel type to Line to see the trend.

Step 5: Set a threshold alert

1. Click Alerts in the sidebar
2. Click New Alert
3. Set the metric to my.first.metric
4. Set the condition: value above 100
5. Save

Now push a value over 100:

curl -X POST https://numbrs.lol/api/ingest \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"metric": "my.first.metric", "value": 150}'

The alert will fire. You’ll see it in the Alerts section.

What’s next

You’ve got the basics down. Here’s where to go from here:

• Track your Nostr relay — Relay Monitoring. Paste a wss:// URL and get latency and uptime graphs.
• Track Claude AI usage — Claude AI Usage. The most powerful integration if you use Claude Code or OpenClaw heavily.
• Push real system stats — Custom Metrics has bash scripts for CPU, RAM, disk, and more.
• Set up Jellyfin or Plex tracking — Jellyfin or Plex.