RunWisp documentation

RunWisp is a single binary that replaces cron and a process supervisor. You describe your scheduled tasks and long-running services in one runwisp.toml. Every run gets an exit code, duration, and captured output, which you can browse in the built-in Web UI, the terminal UI, or the REST API.

Where to start

• New to RunWisp? Follow Getting started, five short pages from install to a server.
• Coming from cron, supervisord, systemd, or docker-compose? Start with Migrating.
• Want to look around first? Run runwisp demo for a throwaway instance with hundreds of past runs.
• Looking up a key or a command? Go to the configuration reference or the CLI reference.

Something broken? Start with Troubleshooting.

Getting started

• Installation
• Your first task
• Running a service
• Handling failures
• Running on a server

Guides

• Tasks and services
• Scheduling / cron, timezones, catch-up
• Overlapping runs / concurrency, flock
• Failures, retries & timeouts
• Parameters / arguments, inputs
• Run logs / output, retention, search
• Web UI and TUI
• Notifications / alerts: Slack, Discord, Telegram, ntfy, Gotify, Pushover, email over SMTP, email via a local MTA, webhook
• Docker tasks / containers
• Remote triggers / webhooks, CI deploy hooks

Examples

• Nightly backup
• Health checks

Migrating

• Overview
• From cron / crontab
• From supervisord
• From systemd units and timers
• From docker-compose

Production

• Best practices
• Running in Docker
• Autostart / systemd, launchd
• Reload & restart / SIGHUP
• Authentication / password, reverse proxy
• Daemon log
• Metrics / Prometheus
• Troubleshooting

Reference

• Configuration: overview, [tasks.*], [services.*], [compose.*], [defaults], [daemon], [storage], [notify], [[route]], ${...} substitution
• CLI
• REST API
• AI agents

RunWisp is open source (GPL-3.0-or-later) at github.com/runwisp/runwisp. Release notes are in the CHANGELOG.