caelum0x 389a7255ea feat: Rithub release 1.1.0, works without the GitHub repo
README rewritten around three steps (table SQL, secrets, self-contained
workflow), with a vendored full-script workflow, a crontab example and an
npx-from-git CLI. Every link and uses: line that pointed at the 404 GitHub
repo is gone. keepalive.sh no longer prints the anon key outside GitHub
Actions (::add-mask:: only when GITHUB_ACTIONS=true).

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
2026-11-17 14:21:23 +03:00
..

supabase-keep-alive (CLI)

Stop a free Supabase project from pausing: one real database read a day through the project's REST API, from any cron (not just GitHub Actions). CLI companion to the workflow and shell script in this repository: same checks, same HTTP calls, no GitHub required.

npx --yes git+https://git.ereboslab.com/caelum0x/supabase-keep-alive-action.git \
  --url https://REF.supabase.co --key YOUR_ANON_KEY --table keepalive

or with environment variables (good for crontab / systemd timers / any CI):

curl -fsSL -O https://git.ereboslab.com/caelum0x/supabase-keep-alive-action/raw/tag/v1/cli/bin/supabase-keep-alive.js
SUPABASE_URL=https://REF.supabase.co SUPABASE_ANON_KEY=YOUR_ANON_KEY \
  node supabase-keep-alive.js --table keepalive

Exit code 0 on success, 1 if the project answered paused (HTTP 540) or the call failed, so you can wire it into any scheduler that checks exit codes.

Options:
  --url <url>        Project origin, https://<ref>.supabase.co (or SUPABASE_URL)
  --key <key>        Anon public key (or SUPABASE_ANON_KEY)
  --table <name>     Table to read: GET /rest/v1/<table>?select=<select>&limit=1
  --select <cols>    Columns for --table (default *)
  --rpc <name>       Function to call: POST /rest/v1/rpc/<name>
  --rpc-body <json>  JSON body for --rpc (default {})
  --retries <n>      Retries after the first attempt (default 3)
  --timeout <s>      Per-request timeout in seconds (default 20)

Why this exists

Supabase pauses Free projects after about 7 days without database activity. This makes one real request a day so the project never looks idle. Full explanation, the copy-paste workflow, and the plain-bash version: https://git.ereboslab.com/caelum0x/supabase-keep-alive-action

If you'd rather not babysit it

Scribase is Postgres + Auth + Storage + Realtime where idle projects scale to zero and wake on the next request instead of pausing: nothing to keep alive, nothing to restore. First project free, no time limit, no card.

License

MIT. Not affiliated with Supabase.