Skip to the products
LCPanelLicence Center Panel

Scheduled jobs

The one cron line, the web line with its key, the page heartbeat when there is no cron, every job with its interval, and Background Tasks.

Keeping it running Updated 6 Nov 2026 16 / 50

One cron line runs everything BoxPuff does in the background. Each job remembers when it last ran in bp_cron_log and only runs when its interval has passed, so a line that fires every minute costs almost nothing most of the time.

The cron line

Admin → System Tools → Background Tasks shows two lines ready to copy. Add ONE of them to cPanel → Cron Jobs, every minute:

* * * * * /usr/bin/php /home/user/public_html/cron/run.php >/dev/null 2>&1

The page prints the real PHP binary and the real path of your installation (and swaps php-cgi for php where a host reports the CGI binary). Hosts without a command line use the web line instead:

* * * * * wget -q -O /dev/null "https://example.com/cron?key=<cron key>"

/cron refuses to run without the key; New key makes a fresh one (and the old web line stops working). The command line never needs a key. cron/run.php may also be run by hand over SSH; php cron/run.php prints what each job did.

The header of the page says cron line running or cron line not arriving (no run recorded in the last ten minutes) with the last run time, and Run all due jobs now runs everything that is due from the browser.

When there is no cron

Until the line is in place the site keeps going: every public page prints a tiny heartbeat that posts to /beat once a minute per browser and runs the most urgent jobs there. It is slower for visitors and stops when nobody is on the site, so it is a stop-gap, not a replacement. Site Settings → Logs → Page heartbeat runs jobs when there is no cron switches it off; Warn when the cron is not arriving controls the notice at the top of the admin panel.

The jobs

JobEveryWhat it does
Process file queue (process_file_queue)1 minDeletes, moves and copies waiting on the file servers (the Action Queue).
Currency rates (currency_rates, Multi Currency plugin)1 dayFetches the online exchange rates for the currencies marked auto (Multi Currency).
Remote URL downloads (process_remote_file_downloads)1 minFetches queued remote URLs into accounts, three per run.
Downgrade expired accounts (downgrade_accounts)1 hPaid accounts whose time ran out go back to the free package.
Auto prune (auto_prune)1 hRemoves inactive files (Days To Keep Inactive Files), empties old trash, deletes stale trial accounts, expires shares.
Purge deleted files (delete_redundant_files)1 hRemoves rows of files deleted long enough ago (Purge deleted files after), sweeps uploads/tmp/ and old zips, prunes notifications.
Internal notifications (create_internal_notifications)1 hPremium ending soon, files about to go.
E-mail queue (create_email_notifications)2 minSends queued e-mails, 50 per run.
Server resources (process_server_resources)5 minRecords disk, load and connections of monitored file servers and refreshes their totals.
Server availability (process_server_monitoring)5 minPings Direct file servers with the availability checker on and drops unreachable ones from the pool; closes dead download-tracker rows.
Statistics roll-up (stats_rollup)1 daySquashes old per-download rows into the daily totals.
Licence heartbeat (license_check)12 hVerifies the licence with the License Center.
Session purge (session_purge)1 hRemoves expired database sessions, download tokens and member tokens.

Plugins add their own jobs to the same list: Thumbnails (File Previewer, 5 min), Archive queue, Media converter queue, Track torrents, Newsletters: send queue, Rewards: clear and aggregate, Payments: expire old orders.

The table on Background Tasks

For every job: its label and what it does, Every, Last run with how many seconds it took, Result (ok, error or running, with the job's own message such as 12 action(s) done), and Run now. A job that is still marked running is skipped by later runs for an hour so two copies never overlap; a job that throws is marked error, its message is written to logs/cron.log, and the other jobs still run.

A Direct file server needs the line too

Add the same cron line on every Direct file server (with that machine's path). Its Process file queue is what deletes and moves its own files; without it the Action Queue waits.

Tips

  • One line, every minute, always. Do not try to schedule the jobs separately: the intervals are inside.
  • If the panel keeps saying cron line not arriving although cPanel shows the job, run the command over SSH and read what it prints - usually a wrong PHP path.
  • Hosts that forbid wget accept curl -s "https://example.com/cron?key=..." >/dev/null just as well.
  • Set Server resources monitoring on your local server; the dashboard's disk figure comes from it.
Was this helpful?
Share this chapter