A simple webapp to manage cronjobs
Go to file
Jeroen De Meerleer c039004d62
UPDATED README
2022-09-05 16:13:31 +02:00
.github/issue_template ENHANCEMENT: created issue_templates 2022-06-24 14:20:03 +02:00
assets UPDATED DEPENDENCIES 2022-09-05 16:13:01 +02:00
bin ENHANCEMENT: using symfony framework 2022-04-27 17:19:54 +02:00
config NEW FEATURE: added version tag 2022-09-05 15:09:12 +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 NEW FEATURE: added version tag 2022-09-05 15:09:12 +02:00
templates NEW FEATURE: added version tag 2022-09-05 15:09:12 +02:00
translations NEW FEATURE: added host label 2022-08-18 14:02:31 +02:00
.env.sample ENHANCEMENT: added demo mode 2022-07-01 12:00:36 +02:00
.gitignore Returning to webpack 2022-08-23 13:28:30 +02:00
LICENSE.md First implementation of the framework 2021-04-06 19:33:26 +02:00
README.md UPDATED README 2022-09-05 16:13:31 +02:00
composer.json Returning to webpack 2022-08-23 13:28:30 +02:00
composer.lock UPDATED DEPENDENCIES 2022-09-05 16:13:01 +02:00
install.sh UPDATED README 2022-09-05 16:13:31 +02:00
package-lock.json UPDATED DEPENDENCIES 2022-09-05 16:13:01 +02:00
package.json Returning to webpack 2022-08-23 13:28:30 +02:00
symfony.lock Returning to webpack 2022-08-23 13:28:30 +02:00
webpack.config.js ENHANCEMENT: add.js was shared between add and edit 2022-09-01 17:03:46 +02:00

README.md

Webcron Management

(c) 2017-2018, 2021- Jeroen De Meerleer me@jeroened.be

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

Known bugs

Deploying

Requirements for web-server

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

Requirements for build-server

  • php <= 8.1 (incl composer <= 2)
  • NodeJS <= 16.0 (incl. npm <= 8)

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

  1. Create your database and import the storage/database.sql file into the database
  2. Create a first user by inserting a first record to the users table (Password is hashed using the HASHING_METHOD in your .env)
  3. Set up your webhosting to use the /public directory as web root
  4. Upload the repository to the webserver
  5. 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