Introduction

Schedy is a self-hostable, ultra-lightweight HTTP task scheduler - fire HTTP requests to any endpoint at any time, with headers, payloads, retries, and full status tracking.

Schedy schedules an HTTP request to any endpoint at any time - with headers, payloads, retries, and full status tracking.

It is a single Go binary with an embedded BadgerDB store. No external database, no message queue, no cron files. You talk to it over a small HTTP API, it fires your requests when they are due, and it keeps a record of what happened.

Quick start

Run the server:

docker run -p 8080:8080 ghcr.io/ksamirdev/schedy:latest

Schedule a task:

curl -X POST http://localhost:8080/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "execute_at": "2030-05-26T15:00:00Z",
    "url": "https://example.com/webhook",
    "payload": {"hello": "world"}
  }'

That’s it - Schedy will POST your payload to the URL at the scheduled time and record the outcome.

Explore

Install & Run

Docker, prebuilt binaries, Kubernetes, or build from source.

Status & History

How every task reports what happened, attempt by attempt.

Retries

Fixed or exponential backoff with full jitter.

API Reference

Every endpoint, field, and response code.