Starting from Tiki 30, long-running operations (e.g. PDF generation, instance creation, maintenance tasks) can be executed asynchronously using a background job queue system. This avoids timeouts during HTTP requests and improves responsiveness for users.

The system provides:

• A task queue table (tiki_queued_tasks)
• A task lifecycle tracking status and result
• A CLI worker to process tasks
• UI integration for monitoring queued tasks

A task moves through the following standard lifecycle:

[ pending ] → [ running ] → [ completed/ failed ]

Where:

• pending — Task is waiting to be executed
• running — T ask is being processed
• completed — Task executed successfully
• failed Task — encountered an error

• Run queue (once):
  php console.php queue:process
• Run continuously:
  php console.php queue:process --loop (Ctrl+C to stop the process)

• Enable the queued tasks feature
  1. Log in as an administrator.
  2. Open Admin → General (tiki-admin.php?page=general).
  3. Find the Queued Tasks option.
  
  
  

  Click to expand

• Confirm that the Queued Tasks admin page is now visible
  
  

  Click to expand

• Trigger a PDF export from the Browser
  
  

  Click to expand
  
  Expected UI behavior: A banner that includes a link to the queued task
  
  

  Click to expand

• Inspect queued task in Admin UI
  
  

  Click to expand

Open the task details and read the error shown in Output.
The message usually explains the cause, such as:

• missing permissions
• invalid configuration
• missing dependencies
• PHP/runtime exceptions
• network or database issues

Failed tasks are not retried automatically.
Once the issue is corrected, simply repeat the action that created the task.