Skip to content

gocron

Developer Productivity

A task scheduler built with Go and Vue.js that runs recurring jobs defined in a YAML configuration file

Track releases GitHub
Go Latest v0.9.13 · 21d ago Security brief →

Features

  • Simple YAML‑based job definition with cron schedules
  • Supports environment variables per job
  • Easy addition and removal of jobs via config file
  • Docker container ready for quick deployment

Recent releases

View all 9 releases →
No immediate action
v0.9.13 New feature

Injectable HTTP client

Open
v0.9.12 Breaking risk
⚠ Upgrade required
  • Update startup command to point --config directly at the YAML file.
  • Move any SQLite path customization into the new `db` section of the config.
  • Set `db.location` to `.` and leave `db.name` as `db.sqlite` to retain previous default behavior.
Breaking changes
  • --config flag expects a path to the YAML config file instead of a config folder
  • SQLite settings relocated under db section; use db.location for directory, db.name for filename
Full changelog

Breaking Changes

The --config flag now expects a path to the actual YAML config file, not a config folder. For example, use /path/to/config.yaml instead of /path/to/config or ./config.
Existing setups that relied on the old config-folder flag behavior must update their startup arguments before upgrading.

The SQLite configuration is now defined under a dedicated db section. Database directory is configured with db.location, and database file name is configured with db.name.

Job detail routes now use generated URL-safe slugs instead of raw job names. Slugs are derived automatically from the configured job name and must be unique.

Migration

Update your startup command to point --config directly to the config file.
Move any SQLite path customization into the db section.
To keep the previous default behavior, set db.location to . (the same folder as the config file) and leave db.name as db.sqlite.
Ensure job names produce unique slugs if you use the web UI, since duplicate slugs are now rejected during config loading.

Changes in This Release

  • Add reusable CI workflow and unit tests (f343e58) by @flohoss
  • Replace Codecov with go-coverage-report (3d4cc33) by @flohoss
  • Remove deprecated reuse-go input from go-coverage-report (473e5ae) by @flohoss
  • Replace Codecov badge with go-coverage-report badge (b666f66) by @flohoss
  • Add unit tests for config, buildinfo and CLI (4c1467f) by @flohoss
  • Refactor Config File Path Handling (a8c3729) by @flohoss
  • Add Configurable SQLite Database Settings (d16d5e1) by @flohoss
  • Add Slug-Based Job Routes (26baabf) by @flohoss
  • Clarify and reorder test instructions in README (6a99bbf) by @flohoss
  • Merge pull request #54 from flohoss/53-refactor-config-path-handling-and-add-configurable-sqlite-db-namelocation (d86fc18) by @flohoss
  • Rename upload-codecov to generate-coverage-report (6fadcde) by @flohoss

Full Changelog: https://github.com/flohoss/gocron/compare/v0.9.11...v0.9.12

Docker Image

docker pull ghcr.io/flohoss/gocron:v0.9.12
docker pull ghcr.io/flohoss/gocron:latest

Binary Downloads

Download one of the attached binaries extracted from the release image:

  • gocron_<version>_linux_amd64
  • gocron_<version>_linux_arm64

Verify with ./gocron_<version>_linux_<arch> --version.

Image digest:

ghcr.io/flohoss/gocron:v0.9.12@sha256:914f81c74d05623f94d70c021f6c8a8aac94d6f91f3cb3005289c3ff920d61f3

Build Information

  • Version: v0.9.12
  • Build Time: 2026-05-11T04:39:31Z
  • Repository: https://github.com/flohoss/gocron
  • Platform: linux/amd64,linux/arm64
  • Attestations: SLSA Provenance, SBOM
View release on GitHub
v0.9.11 New feature
Notable features
  • Added --config flag to specify custom config folder (creates/uses config.yaml and sqlite DB there)
  • Embedded web UI into the binary for a self‑contained runtime
  • Added --version output with embedded build metadata
Full changelog

This release improves standalone binary usage and deployment flexibility.

Added startup flag --config to use a custom config folder (config.yaml and sqlite DB are created/used there)
Added --version output with embedded build metadata
Embedded the web UI into the binary for a more self-contained runtime
Improved first-run config file creation behavior
Release artifacts now include Linux binaries for amd64 and arm64, plus checksums
Notes
Linux release binaries are attached as:

gocron_<version>_linux_amd64
gocron_<version>_linux_arm64

Use:
./gocron_<version>linux<arch> --version

Thanks @JuliusFreudenberger for porting this package to nix ❤️

Changes in This Release

  • Make config paths configurable (2e41a8e) by @flohoss
  • Add build metadata package (0a5aae4) by @flohoss
  • Add --config and --version startup flags (8d6d7b2) by @flohoss
  • Embed web UI into binary with filesystem fallback (028913a) by @flohoss
  • Update Dockerfiles for embedded web UI and build metadata (5596ddf) by @flohoss
  • Publish standalone linux binaries as release artifacts (fefacbd) by @flohoss
  • Update .gitignore and README for standalone binary (c243ddd) by @flohoss
  • Merge pull request #52 from flohoss/51-feat-standalone-binary-distribution-with-embedded-web-ui-and-cli-flags (3ca16f6) by @flohoss
  • Fix README release binary wording and links (125174b) by @flohoss
  • Add dedicated web/e2e Cypress package & compose services (34c84f0) by @flohoss
  • Add Cypress tests for GUI navigation & modals (326cf9e) by @flohoss
  • Add unit tests and CI test job (18d7e6c) by @flohoss
  • Add tests for config and command execution (404de2d) by @flohoss
  • Add default starter jobs and tests (b7b8472) by @flohoss
  • Use 'UTC' as default timezone (2aed82e) by @flohoss

Full Changelog: https://github.com/flohoss/gocron/compare/v0.9.10...v0.9.11

Docker Image

docker pull ghcr.io/flohoss/gocron:v0.9.11
docker pull ghcr.io/flohoss/gocron:latest

Binary Downloads

Download one of the attached binaries extracted from the release image:

  • gocron_<version>_linux_amd64
  • gocron_<version>_linux_arm64

Verify with ./gocron_<version>_linux_<arch> --version.

Image digest:

ghcr.io/flohoss/gocron:v0.9.11@sha256:47a7af0e744a26d1c096a86212c2990723eff2a0ca82b43349aabf26ee271af2

Build Information

  • Version: v0.9.11
  • Build Time: 2026-05-08T18:35:14Z
  • Repository: https://github.com/flohoss/gocron
  • Platform: linux/amd64,linux/arm64
  • Attestations: SLSA Provenance, SBOM
View release on GitHub
v0.9.9 Maintenance

Minor fixes and improvements.

Full changelog

Changes in This Release

  • Bump the gomod group with 2 updates (158819b) by @dependabot[bot]
  • Bump the github-actions group with 4 updates (89f3a11) by @dependabot[bot]
  • Merge pull request #47 from flohoss/dependabot/github_actions/github-actions-6534b7915f (8fd8c7e) by @flohoss
  • Merge pull request #46 from flohoss/dependabot/go_modules/gomod-daad1015fd (d6e9299) by @flohoss
  • Remove .templ build exclusion (9343715) by @flohoss
  • Use docker bake in CI and unify container args (09f4b18) by @flohoss
  • Bump Go to 1.26 and update indirect deps (374fa2e) by @flohoss
  • Add V_NODE arg and specify release Dockerfile (d04459b) by @flohoss

Full Changelog: https://github.com/flohoss/gocron/compare/v0.9.8...v0.9.9

Docker Image

docker pull ghcr.io/flohoss/gocron:v0.9.9

Image digest:

ghcr.io/flohoss/gocron:v0.9.9@sha256:f9f3c78347d157ad9fe17de523a92489314f093549d853631bbdaccbacb62f2c

Build Information

  • Version: v0.9.9
  • Build Time: 2026-04-21T18:00:20Z
  • Repository: https://github.com/flohoss/gocron
  • Platform: linux/amd64,linux/arm64
  • Attestations: SLSA Provenance, SBOM
View release on GitHub
v0.9.8 Breaking risk
Breaking changes
  • Make command field required in OpenAPI.
Notable features
  • Add /health endpoint and Docker healthchecks
  • Increase Docker healthcheck timing in compose.yml
Full changelog

Changes in This Release

  • Add sqlc/yarn services and wait-for-url script (ee362ed) by @flohoss
  • Add Cypress E2E tests and selectors (54b0680) by @flohoss
  • Add GitHub Actions workflow for tests (21ad324) by @flohoss
  • Add /health endpoint and Docker healthchecks (f8057e4) by @flohoss
  • Increase Docker healthcheck timing in compose.yml (2bb8223) by @flohoss
  • Bump the gomod group with 2 updates (41f0cb2) by @dependabot[bot]
  • Move changes and changelog earlier in release notes (7eb484d) by @flohoss
  • Remove GitHub Actions test workflow (adff86c) by @flohoss
  • Bump web dependencies and update lockfile (f744d27) by @flohoss
  • Add 'Run tests' instructions to README (f02e881) by @flohoss
  • Refactor router init and remove scalar API asset (ad87cc4) by @flohoss
  • Bump Go deps; change README service to backend (fa2f157) by @flohoss
  • Merge pull request #45 from flohoss/dependabot/go_modules/gomod-5b7dc2c640 (4dfbf15) by @flohoss
  • Make command field required in OpenAPI (d0daaee) by @flohoss

Full Changelog: https://github.com/flohoss/gocron/compare/v0.9.7...v0.9.8

Docker Image

docker pull ghcr.io/flohoss/gocron:v0.9.8

Image digest:

ghcr.io/flohoss/gocron:v0.9.8@sha256:d1a9cfaf2f85b1acf50ea69e625bf8b3a0babe88b38ddef40fce771e6c5134ac

Build Information

  • Version: v0.9.8
  • Build Time: 2026-03-18T12:51:30Z
  • Repository: https://github.com/flohoss/gocron
  • Platform: linux/amd64,linux/arm64
  • Attestations: SLSA Provenance, SBOM
View release on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

About

Stars
543
Forks
18
Languages
Go Vue TypeScript
View on GitHub

Install & Platforms

Install via
docker binary
Platforms
linux

Similar tools

gocron
WebHook Tester
µTask
PruneMate
DaKheera47/job-ops](https:

Beta — feedback welcome: [email protected]