🕰️ Monitor your cron jobs
minicron makes it simple to monitor your cron jobs and ensure they are running both correctly and on schedule.
⚠️ minicron is no longer being worked on
The latest release is v0.9.6,
but0.9.xis not being actively developed or supported.This branch (master) is the current state of progress towards a v1.0 release however
I am not currently actively working on it due not having sufficient time to dedicate to the
project as I did in the past.
minicron runs your jobs via its easy to install client which lives on your server and relays the job data back to the
server (web ui) where you can view it and set up alerts to ensure the job is running correctly.
I initially developed minicron as part of my dissertation at university in 2014. The motivation for developing minicron comes
largely from my experience and frustrations using cron both in a personal and professional capacity.
Should run on OSX and any Linux/BSD based OS.
A simple example config for nginx is provided.
If you’re using apache as your reverse proxy you need to ensure you have the following modules installed:
libapache2-mod-proxy-htmlapache2-utilsRun the following to enable them and then restart apache
a2enmod proxy proxy_html proxy_http xml2enc.
A simple example config for apache is provided.
TODO: update for 1.0
minicron run 'mysqldump db > backup.sql'
The global --verbose option can also be passed to the run argument like so
minicron run --verbose ls
You can also run a command in ‘dry run’ mode to test if it works without sending the output to the server.
minicron run --dry-run 'zip -r backup.zip website'
for further information see minicron help run.
Running minicron with no arguments is an alias to running minicron help, minicron -h or minicron --help.
You can also use the help argument to get information on any command as shown above in the run a command section
or alternatively you can pass the -h or --help options like so minicron run -h.
To launch the server (aka the Hub) run
minicron server start
by default it will bind to port 9292 on the host 0.0.0.0 but this can be configured by the command line
arguments --host --port and --path or in the config file.
By default the server will run as a daemon with its process id stored in /tmp/minicron.pid
you can also use the stop, restart and status commands to control the server.
To run the server in debug mode, so you can see its output and any errors, you can pass the --debug
option.
Like many command line programs minicron will show its version number when the global options -v
or --version are passed to the CLI.
Some configuration options can be passed in manually but the recommended way to configure minicron is through the use
of a config file. You can specify the path to the file using the --config global option. The file is expected
to be in the toml format. The default options are specified in the
server.toml file and minicron will parse a config located in /etc/minicron/server.toml if it
exists. Options specified via the command line will take precedence over those taken from a config file.
All stable releases will follow the semantic versioning guidelines.
Releases will be numbered with the following format:
<major>.<minor>.<patch>
Based on the following guidelines:
Feedback and pull requests are welcome. Please see CONTRIBUTING.md
for more info.
Areas that I would love some help with:
Where possible I will try to provide support for minicron but I offer no guarantees.
Feel free to open an issue and I’ll do my best to help.
minicron makes use of a lot of awesome open source projects that have saved me a lot of time in its development.
I started out trying to list all of them but it was taking way too much time so check out the dependencies in
minicron.gemspec and
app.rb.
minicron is licensed under the GPL v3 - see here for the full license