webcron
/
webcron
1
0
Fork 0
Code Issues 6 Pull Requests Projects 1 Releases 6 Wiki Activity
A simple webapp to manage cronjobs
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
356 Commits
1 Branch
6 Tags
2.3 MiB
PHP 52.3%
Twig 30.6%
JavaScript 10.1%
Shell 3.9%
SCSS 3.1%
 
 
 
 
 
main
1.1
1.1-beta1
1.1-alpha2
1.1-alpha1
v1.0
v1.0-beta1
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '14dc261510'
${ noResults }
Go to file
Jeroen De Meerleer 14dc261510
ENHANCEMENT: fixing the locale 		10 months ago
assets NEW FEATURE: added translations 10 months ago
bin ENHANCEMENT: using symfony framework 11 months ago
config BUGFIX: better security 10 months ago
migrations ENHANCEMENT: using symfony framework 11 months ago
public ENHANCEMENT: using symfony framework 11 months ago
src ENHANCEMENT: fixing the locale 10 months ago
templates ENHANCEMENT: moar translating 10 months ago
translations ENHANCEMENT: Added initial en-l33t translation 10 months ago
.env.sample UPDATED INSTALL SCRIPT 11 months ago
.gitignore Using Vite instead of webpack 11 months ago
LICENSE.md First implementation of the framework 2 years ago
README.md UPDATED DEPENDENCIES 1 year ago
composer.json ENHANCEMENT: use posix signal to check if daemon is running 10 months ago
composer.lock ENHANCEMENT: use posix signal to check if daemon is running 10 months ago
install.sh UPDATED INSTALL SCRIPT 11 months ago
package-lock.json Updated dependencies 10 months ago
package.json Bugfix because TD is still beta 11 months ago
symfony.lock NEW FEATURE: added translations 10 months ago
vite.config.js Using Vite instead of webpack 11 months ago

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.

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

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

  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