Set up UptimeFlare and create your first monitor,
Installation / Setup
Follow the official UptimeFlare quickstart closely. This is the simplest setup path and does not require a VPS, Docker, or local deployment tools.
- Create a Cloudflare account and a GitHub account.
- In Cloudflare, create an API token based on Edit Cloudflare Workers, then add D1 Edit permissions so UptimeFlare can deploy its worker and database resources.
- If your Cloudflare account is new, open the Workers section once. This initializes your
workers.devsubdomain, which UptimeFlare needs during deployment. - Open the official UptimeFlare repository and click Use this template to create your own GitHub repository.
- In your GitHub repository, go to Settings → Secrets and variables → Actions and create a secret named
CLOUDFLARE_API_TOKEN. - Edit
uptime.config.tsin the root of your repository. This is where you define monitors, status page details, and notification settings. - Commit the change and let GitHub Actions run. The deployment should create the worker, status page, and related Cloudflare resources automatically.
After the workflow succeeds, open Cloudflare Workers & Pages and confirm the deployment exists. At that point, your UptimeFlare instance is live and ready for your first monitor.
Create your first monitor
Start with one simple HTTP monitor so you can confirm the installation works before you add notifications.
TypeScript
monitors: [
{
id: 'signalgrid-homepage',
name: 'Signalgrid Homepage',
method: 'GET',
target: 'https://signalgrid.co',
},
],
Save the config, wait for GitHub Actions to redeploy, and then open your UptimeFlare dashboard or status page. If the monitor appears and starts checking your target URL, the setup is working.
For a first test, keep it simple:
- Use a public URL that should reliably return
200 OK. - Give the monitor a clear name.
- Deploy the change.
- Confirm that the monitor shows up before moving on to notifications.
Alerting / Push Notifications
Once the monitor works, add a webhook so UptimeFlare sends downtime and recovery alerts to Signalgrid.
You will need:
- A Signalgrid account (Sign up here)
- Your Signalgrid
client_key - A Signalgrid channel token
Add a webhook to your UptimeFlare configuration like this:
TypeScript
webhook: {
url: 'https://api.signalgrid.co/v1/push',
payloadType: 'x-www-form-urlencoded',
payload: {
client_key: 'YOUR_CLIENT_KEY',
channel: 'YOUR_CHANNEL_TOKEN',
title: 'UptimeFlare Notification',
body: '$MSG',
type: 'INFO',
},
},
This sends the human-readable UptimeFlare event text to Signalgrid. After saving the change, redeploy the config and trigger a test alert by temporarily pointing a monitor to a failing endpoint or by testing the Signalgrid API directly first.
Bash
curl -X POST https://api.signalgrid.co/v1/push \
-d "client_key=YOUR_CLIENT_KEY" \
-d "channel=YOUR_CHANNEL_TOKEN" \
-d "title=Signalgrid test" \
-d "body=Direct API test from the UptimeFlare integration guide" \
-d "type=INFO"
If that test arrives on your phone, your Signalgrid side is ready. Then the last step is simply waiting for the next real monitor event from UptimeFlare.