Skip to main content

Troubleshooting Email


Sometimes you may want to manually run incoming email processing, for example, to debug connection problems.

To do this on Linux/Unix:

cd /path/to/deskpro
php bin/cron -vfj process_email_gateways

To do this on Windows:

cd C:\path\to\Deskpro
C:\path\to\php.exe bin\cron -vfj process_email_gateways

The -v flag enables verbose output; the -f flag forces the task to run (otherwise it might be throttled); the -j flag specifies that you only want to run process_email_gateways (otherwies all scheduled tasks would run).

Running one specific account

Sometimes it's useful to only run one specific email account in verbose mode. This can be helpful in cases where you have a bunch of accounts, and only one of them is having an issue.

cd /path/to/deskpro
php bin/cron -vfj process_email_gateways -o '{"run_account_id": 123}'

The 123 is the email account ID. You can get this from the admin interface in the email accounts section by showing IDs.

Saving the log to a file

You can redirect the output of the command to a file. This is useful if you need ot send the output to a support agent.

On Linux:

php bin/cron -vfj process_email_gateways | tee dbg.txt

And on Windows:

C:\path\to\php.exe bin\cron -vfj process_email_gateways > dbg.txt & type dbg.txt

In both cases, this will save the log output to a dbg.txt file in your current working directory.

Authors list

First published: 21/03/2017

Last updated: 9 Aug 2018 by Christopher Nadeau