meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
cron [2023/06/23 16:20] – [Cron Scripts] johnnycron [2025/10/07 20:30] (current) – johnny
Line 1: Line 1:
 ====== Cron ====== ====== Cron ======
  
-ITFlow comes packaged with several PHP scripts that are intended to be run automatically via Cron. Running scripts via Cron ensures that things happen automatically in the background without requiring a logged in user. +ITFlow comes with an array of PHP scripts that are meant to be executed automatically using Cron. The operation of scripts via Cron guarantees that actions are carried out autonomously in the background, eliminating the need for a user to be logged in. We strongly recommend configuring cron.
  
-==== Cron Enable & Key ====+==== Cron Activation ====
  
-In order to ensure only Cron executes the scripts (and not some random user/bot navigating to the pages), you must enable cron & generate and provide a Cron Key.+  * Sign in to ITFlow with administrative rights. 
 +  * Navigate to **Settings** > **Notifications**: 
 +  * Enable Cron
  
-Login to ITFlow as an admin. Navigate to **Settings** > **Alerts**: +== Cron Scripts of v25.10.1 == 
-  * Enable cron +If installed by script after the date above location will now be ''/etc/cron.d/itflow'' 
-  * Generate a Cron Key+<code> 
 +0 2 * * * www-data /usr/bin/php /var/www/itflow.example.com/cron/cron.php 
 +* * * * * www-data /usr/bin/php /var/www/itflow.example.com/cron/ticket_email_parser.php 
 +* * * * * www-data /usr/bin/php /var/www/itflow.example.com/cron/mail_queue.php 
 +0 3 * * * www-data /usr/bin/php /var/www/itflow.example.com/cron/domain_refresher.php 
 +0 4 * * * www-data /usr/bin/php /var/www/itflow.example.com/cron/certificate_refresher.php 
 +</code>
  
-==== Cron Scripts ====+-- 
 + 
 +== OLD / Cron Scripts ==
 The following scripts should be added to your Cron: The following scripts should be added to your Cron:
-  * php /full/path/to/**cron.php** **[KEY]** -- Should execute at 2 AM daily: cleanup, alerts, recurring invoices, etc. +  *NOTE: THESE ARE SETUP BY DEFAULT IF YOU INSTALLED ITFLOW USING THE [[installation_script|SCRIPT]] 
-  * php /full/path/to/**cron_ticket_parse.php** **[KEY]** -- Should execute every min: parses tickets + 
-  * php /full/path/to/**cron_mail_queue.php** **[KEY]** -- Should execute every min: Used for emailing within the application+  * ''sudo -u www-data php /full/path/to/**cron.php**'' -- This should run daily at 2 AM for tasks such as cleanup, auto-closing resolved tickets, alerts, recurring invoices, and more. 
 +  * ''sudo -u www-data php /full/path/to/**cron_ticket_email_parser.php**'' -- This should run every minute: it interprets emails and creates/updates tickets 
 +  * ''sudo -u www-data php /full/path/to/**cron_mail_queue.php**'' -- This should run every minute: it's used for in-app email sending 
 +  * ''sudo -u www-data php /full/path/to/**cron_domain_refresher.php**'' -- This should run every day: each run will update the details of the oldest updated domain 
 +  * ''sudo -u www-data php /full/path/to/**cron_certificate_refresher.php**'' -- This should run every day: each run will update the details of the oldest updated certificates.
  
-Please note: Swap [KEY] with your actual Cron key, and don't include the brackets [ ]+== OLD / Example == 
 +<code> 
 +# /etc/crontab: system-wide crontab
  
 +# ITFlow - Nightly cron script
 +0  02   * * *   root    php /var/www/pr-review-base.itflow.org/cron.php 4PlrCJ2kJ5cvf4jnJmoB2E1oTY4PsX8w 2>&1 | logger -t itflow-nightlycron
 +</code>
 +{{:cron_example.png?direct|}}