Skip to content

Latest commit

 

History

231 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Cron GUI

Cron GUI

Manage cron jobs from a modern web UI — without touching raw crontab text.

npm version CI Docker Pulls Node License: MIT

Cron GUI is a drop-in successor to crontab-ui with a rebuilt interface, safer deploy workflow, and dozens of bug fixes. Create, edit, pause, run, back up, and restore jobs from one place — then deploy to the system crontab when you are ready.

Cron GUI workflow: dashboard, new job, edit, preview, and backups

Highlights

Safe by default Edit jobs in the app first. Review changes, preview the crontab text, then deploy with Save to crontab.
Built for real servers Search, status filters, bulk actions, pagination, and per-job stdout/stderr logs.
Portable Export crontab.db and move jobs between machines without SSH or copy-paste.
Compatible Existing crontab.db files from crontab-ui work as-is.

Quick start

Requires Node.js 20+.

npm install -g cron-gui
cron-gui

Open http://127.0.0.1:8000

# Custom host, port, or data directory
HOST=0.0.0.0 PORT=9000 CRON_DB_PATH=/var/lib/cron-gui cron-gui

# Reset local database and start fresh
cron-gui --reset

See it in action

Job dashboard

Sortable table with live status, next-run hints, and unsaved-change indicators — so you always know what is scheduled and what still needs deploying.

Cron GUI job dashboard with search, filters, and status badges

Create and edit jobs

Schedule presets, cron expressions, logging, and optional email notifications — all in a focused dialog.

New job dialog with schedule presets

Edit job dialog with logging and mail options

Preview before you deploy

See the exact crontab text — environment variables plus one line per enabled job — before writing to the system crontab.

Crontab preview modal showing env vars and job lines

Crontab environment

Set PATH, MAILTO, and other variables once — applied to every deployed job.

Crontab environment settings drawer

Per-job logs

View stdout and stderr history for any job without leaving the page.

Opening per-job stdout logs

Backups and portability

Server-side snapshots, database import/export, and system crontab sync — grouped under Actions.

Actions menu with import, export, and backup options

Manage backups modal with restore and delete

Search, filters, and dark mode

Find jobs instantly, filter by status, and switch themes to match your environment.

Search filter narrowing the job list

Cron GUI in dark mode

Configuration

Variable Purpose
HOST Bind address (default 127.0.0.1)
PORT Port (default 8000)
BASE_URL URL path prefix when behind a reverse proxy
CRON_DB_PATH Directory for crontab.db, backups, and logs
BASIC_AUTH_USER / BASIC_AUTH_PWD HTTP basic auth
SSL_CERT / SSL_KEY HTTPS (both must be set together)
ENABLE_AUTOSAVE Auto-deploy on DB changes

Common flags: --autosave, --reset

Full reference: docs/configuration.md

Docker

docker pull ysskrishna/cron-gui:latest
docker run -d -p 8000:8000 ysskrishna/cron-gui:latest

With Compose:

docker compose up -d

See docs/docker.md for volumes, auth, and production notes.

Migrating from crontab-ui

  1. Install cron-gui instead of crontab-ui — existing crontab.db files are compatible.
  2. Schedule presets: The UI uses 5-field cron expressions plus @reboot. Macros like @hourly still work in crontab if typed manually.
  3. Deploy workflow: Changes are staged in the app until you click Save to crontab (unless --autosave is enabled).

Resources

Support

If you find this project helpful:

Credits

Forked from crontab-ui by alseambusher.

License

MIT © Y. Siva Sai Krishna — see LICENSE for details.


Author's GitHubAuthor's LinkedInAuthor's siteReport Issues

About

Cron GUI is a web interface for managing cron jobs without editing crontab text by hand. Create, edit, pause, run, back up, and restore jobs from one place.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages