{"id":50447736,"url":"https://github.com/butialabs/pingflare","last_synced_at":"2026-05-31T22:32:12.769Z","repository":{"id":360847440,"uuid":"1234855556","full_name":"butialabs/pingflare","owner":"butialabs","description":"Uptime monitoring and heartbeats. Runs on the Cloudflare free tier (Workers + D1) or on any Docker host (Fly.io, Railway, VPS) with SQLite.","archived":false,"fork":false,"pushed_at":"2026-05-28T05:43:20.000Z","size":1185,"stargazers_count":35,"open_issues_count":0,"forks_count":7,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T06:25:17.913Z","etag":null,"topics":["cloudflare","cloudflare-workers","docker","flyio","heartbeat","uptime-monitor"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/butialabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T18:19:42.000Z","updated_at":"2026-05-28T05:43:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/butialabs/pingflare","commit_stats":null,"previous_names":["butialabs/pingflare"],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/butialabs/pingflare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/butialabs%2Fpingflare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/butialabs%2Fpingflare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/butialabs%2Fpingflare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/butialabs%2Fpingflare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/butialabs","download_url":"https://codeload.github.com/butialabs/pingflare/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/butialabs%2Fpingflare/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33752286,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudflare","cloudflare-workers","docker","flyio","heartbeat","uptime-monitor"],"created_at":"2026-05-31T22:32:08.409Z","updated_at":"2026-05-31T22:32:12.762Z","avatar_url":"https://github.com/butialabs.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pingflare 🔥\n\n[![Cloudflare Workers](https://img.shields.io/badge/Cloudflare-Workers-F38020?logo=cloudflare\u0026logoColor=white)](https://workers.cloudflare.com/)\n[![Docker](https://img.shields.io/badge/Docker-ready-2496ED?logo=docker\u0026logoColor=white)](https://hub.docker.com/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![SvelteKit](https://img.shields.io/badge/SvelteKit-2.x-FF3E00?logo=svelte\u0026logoColor=white)](https://kit.svelte.dev/)\n[![D1 Database](https://img.shields.io/badge/Cloudflare-D1-F38020?logo=cloudflare\u0026logoColor=white)](https://developers.cloudflare.com/d1/)\n[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nhttps://github.com/user-attachments/assets/c33e20fd-6a82-4e57-b95a-ec06bbf701f5\n\nUptime monitoring and heartbeats. Runs on the **Cloudflare free tier** (Workers + D1) or on **any Docker host** (Fly.io, Railway, VPS) with SQLite.\n\nSends alerts through Discord, Slack, Telegram, Email, ntfy, Pushover, generic webhooks, Apprise, and Google Chat.\n\n---\n\n## Deploy\n\nTwo deployment modes are supported:\n\n| | Cloudflare Workers | Docker / VPS |\n|---|---|---|\n| **Database** | Cloudflare D1 | SQLite (local file) |\n| **Cron** | Cloudflare Triggers | node-cron (built-in) |\n| **Cost** | Free tier | Depends on host |\n| **Setup** | CF dashboard or `wrangler deploy` | `docker compose up` |\n\n---\n\n## ☁️ Deploy on Cloudflare Workers\n\n\u003e **Recommended:** Fork this repository to your own GitHub account. This gives you full control over updates, pull upstream changes whenever you want, and Cloudflare deploys automatically from your fork on every push.\n\n\u003e **Quick start:** Use the button below to deploy instantly from the current version of this repository. Note that this won't receive future updates automatically.\n\n[![Deploy to Cloudflare](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/butialabs/pingflare)\n\n### 1. Create the D1 database\n\n1. Go to [dash.cloudflare.com](https://dash.cloudflare.com) → **Storage \u0026 Database \u003e D1 SQL Database**\n2. Click **Create database**, name it `pingflare`, and confirm\n\n### 2. Connect the database to the Worker\n\n1. Open **Workers \u0026 Pages**, click on the `pingflare` Worker\n2. Go to **Settings \u003e Bindings \u003e Add binding**\n3. Choose **D1 Database**, set the variable name to `DB`, and select the `pingflare` database\n\n### 3. Set the required secrets\n\nStill on **Settings \u003e Variables**, add the following under **Secret variables**:\n\n| Variable | Required | Description |\n|---|---|---|\n| `ADMIN_USER` | Yes | Username |\n| `ADMIN_PASS` | Yes | Password |\n| `JWT_SECRET` | Yes | Secret used to sign JWT tokens, min 32 characters |\n| `ENCRYPTION_KEY` | Yes | Key used to encrypt notification credentials at rest. Min 32 characters. |\n\n### 4. Redeploy\n\nClick **Deployments \u003e Retry deploy** (or push any commit). On the first request, the Worker automatically creates all database tables.\n\nYour dashboard will be live at `https://pingflare.\u003cyour-subdomain\u003e.workers.dev`.\n\n---\n\n## 🐳 Deploy with Docker\n\n```bash\ncurl -O https://raw.githubusercontent.com/butialabs/pingflare/main/compose.yml\n\n# Edit the file and fill in ADMIN_USER, ADMIN_PASS, JWT_SECRET, ENCRYPTION_KEY\n\ndocker compose up -d\n```\n\nOpen `http://localhost:3000`.\n\n### Environment variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `ADMIN_USER` | Yes | — | Dashboard username |\n| `ADMIN_PASS` | Yes | — | Dashboard password |\n| `JWT_SECRET` | Yes | — | JWT signing key, min 32 chars |\n| `ENCRYPTION_KEY` | Yes | — | AES-GCM key for notification credentials, min 32 chars |\n\n\u003e Mount a volume at `/data` to persist the database\n\n---\n\n## ✈️ Deploy on Fly.io\n\n```bash\nfly launch --name pingflare\nfly volumes create pingflare_data --size 1 --region iad\n\nfly secrets set \\\n  ADMIN_USER=admin \\\n  ADMIN_PASS=yourpassword \\\n  JWT_SECRET=your-jwt-secret-min-32-chars \\\n  ENCRYPTION_KEY=your-enc-key-min-32-chars\n\nfly deploy\n```\n\n---\n\n## Docs\n\n- [LOCAL_DEVELOPMENT.md](docs/LOCAL_DEVELOPMENT.md)\n- [LOCALES.md](docs/LOCALES.md)\n- [API.md](docs/API.md)\n\n---\n\n## Cloudflare Free Tier Limits\n\nWhen running on Cloudflare Workers, Pingflare is designed to stay within free tier limits:\n\n- Workers: 100,000 requests per day\n- D1: 100,000 write rows per day, 5 million read rows per day\n- Cron Triggers: minimum 1-minute interval\n\nWith the default 90-day log retention and automatic cleanup on each cron run, write usage stays bounded proportional to the number of active monitors.\n\n\u003e When running in Docker mode, there are no such limits — SQLite has no row quotas and the cron runs on the same Node.js process.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbutialabs%2Fpingflare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbutialabs%2Fpingflare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbutialabs%2Fpingflare/lists"}