A simple webapp to manage cronjobs

Go to file

Jeroen De Meerleer ecccba9b20 BUGFIX: Added header translation		2022-06-16 15:09:41 +02:00
assets	BUGFIX: tags were not always parsed	2022-06-08 13:24:46 +02:00
bin	ENHANCEMENT: using symfony framework	2022-04-27 17:19:54 +02:00
config	ENHANCEMENT: added CSP again	2022-06-08 13:24:24 +02:00
migrations	ENHANCEMENT: using symfony framework	2022-04-27 17:19:54 +02:00
public	ENHANCEMENT: using symfony framework	2022-04-27 17:19:54 +02:00
src	ENHANCEMENT: added CSP again	2022-06-08 13:24:24 +02:00
templates	BUGFIX: Added header translation	2022-06-16 15:09:41 +02:00
translations	BUGFIX: Added header translation	2022-06-16 15:09:41 +02:00
.env.sample	UPDATED INSTALL SCRIPT	2022-05-05 15:40:58 +02:00
.gitignore	Using Vite instead of webpack	2022-05-04 10:31:48 +02:00
composer.json	ENHANCEMENT: use posix signal to check if daemon is running	2022-05-30 17:10:32 +02:00
composer.lock	Build(deps): Bump guzzlehttp/guzzle from 7.4.3 to 7.4.4	2022-06-10 07:34:51 +00:00
install.sh	UPDATED INSTALL SCRIPT	2022-05-05 15:40:58 +02:00
LICENSE.md	First implementation of the framework	2021-04-06 19:33:26 +02:00
package-lock.json	Updated dependencies	2022-05-30 13:32:07 +02:00
package.json	ENHANCEMENT: better watcher	2022-06-08 12:21:44 +02:00
README.md	UPDATED DEPENDENCIES	2022-01-05 15:53:15 +01:00
symfony.lock	NEW FEATURE: added translations	2022-05-25 16:17:53 +02:00
vite.config.js	Using Vite instead of webpack	2022-05-04 10:31:48 +02:00

README.md

Webcron Management

Webcron management is an easy-to-use interface to manage cronjobs running on a publicly available http-location.

Status update

Rewrite is currently beta-quality. Production-use is possible, but use with caution. Personally, I'm using it myself already in a production-like environment.

Known bugs

Datepicker (Tempus dominus v6) is currently alpha-quality software. Altough the dev states it is usable

Deploying

Requirements for web-server

php <= 8.0
- ext-openssl
- ext-pcntl (highly recommended)
MySQL/MariaDB or SQLite
Ability to change the webroot directory
Ability to run a script as daemon (eg. supervisor or systemd units)

Requirements for build-server

php <= 8.0 (incl composer <= 2)
NodeJS <= 14.0 (incl. npm <= 7)

Building

Please run following command on the build server

$ composer install --no-dev --optimize-autoloader
$ npm install
$ npx build prod
$ rm -rf node_modules # Node modules are only required for building

Configuration

All configuration can be found in .env.sample. Please copy this to file to .env and change its values

Installation

First follow the build and configuration instructions. If you don't follow them correctly Webcron Management won't work correctly

Create your database and import the storage/database.sql file into the database
Create a first user by inserting a first record to the users table (Password is hashed using the HASHING_METHOD in your .env)
Set up your webhosting to use the /public directory as web root
Upload the repository to the webserver
Set up the daemon script using systemd, supervisord or similar system
- If this is not possible running the daemon using a cronjob is still possible using below gist (Not recommended)

0 * * * * cd /path/to/webcron/ && php webcron daemon --time-limit=3600 > /dev/null 1&>2

The webcron interface should now work as expected.

Common pitfalls

Cronjobs are not running

Did you edit the crontab?

I can't do an automatic system upgrade!

Doing a system upgrade requires sudo which has a certain number security measurements. To enable running anything with sudo (eg. sudo apt dist-upgrade -y) the user needs to be able to run sudo without tty and password.

TL;DR