SCRON

A lightweight, efficient cron-like scheduler written in Go that executes shell commands at specified intervals with precise timing and comprehensive logging.

Features

Flexible Scheduling: Schedule jobs using minute and hour patterns with wildcard support
Configuration Reloading: Monitors config file changes for dynamic job updates
Comprehensive Logging: Detailed execution logs using zerolog with configurable levels
Error Handling: Robust error handling with exit code tracking and output capture
Shell Command Support: Execute any shell command via bash
Notifications: Send job status notifications via Gotify

Installation

Recommended: Debian Package (.deb)

Download the latest .deb package from the releases page and install:

Install package

sudo dpkg -i scron_X.X.X_linux_amd64.deb

Configuration file at /etc/scron/config.yml

Configuration

Create a config.yml file in the same directory as the binary (or /etc/scron if install via .deb):

jobs:
  - name: "Daily Backup"
    minute: "0"
    hour: "2"
    command: "backup.sh /data /backup"
  
  - name: "Health Check"
    minute: "*/5"
    hour: "*"
    command: "curl -f http://localhost:8080/health"
  
  - name: "Log Cleanup"
    minute: "30"
    hour: "1"
    command: "find /var/log -name '*.log' -mtime +7 -delete"

Configuration Fields

Field	Description	Format	Examples
`name`	Descriptive job name for logging	String	"Daily Backup", "Health Check"
`minute`	Minute pattern (0-59)	String	`"0"`, `"/5"`, `"15,30,45"`, `""`
`hour`	Hour pattern (0-23)	String	`"2"`, `"/2"`, `"9-17"`, `""`
`command`	Shell command to execute	String	`"echo 'Hello'"`, `"backup.sh"`
`notification`	Name of notification configuration to use	String	`"default"`

Notifications

You can configure notifications for job success or failure using Gotify:

notification:
  - name: default
    success:
      gotify:
        url: https://gotify.example.com/message?token=YOUR_TOKEN
    error:
      gotify:
        url: https://gotify.example.com/message?token=YOUR_TOKEN

jobs:
  - name: "Daily Backup"
    minute: "0"
    hour: "2"
    command: "backup.sh /data /backup"
    notification: default

Notifications support:

Multiple named notification configurations
Separate success and error notification URLs
Optional configuration per job

Pattern Syntax

* - Every minute/hour
*/n - Every n minutes/hours
n - Specific minute/hour
n,m,o - Multiple specific values
n-m - Range of values

Examples

Simple Periodic Task

jobs:
  - name: "Heartbeat"
    minute: "*"
    hour: "*"
    command: "echo $(date): Service running >> /var/log/heartbeat.log"

Business Hours Only

jobs:
  - name: "Business Hours Check"
    minute: "0"
    hour: "9-17"
    command: "business-hours-task.sh"

Multiple Schedules

jobs:
  - name: "Frequent Check"
    minute: "*/2"
    hour: "*"
    command: "quick-check.sh"
  
  - name: "Hourly Report"
    minute: "0"
    hour: "*"
    command: "generate-report.sh"
  
  - name: "Daily Cleanup"
    minute: "0"
    hour: "3"
    command: "cleanup.sh"

3.3 KiB Raw Blame History