Translations of this page:

how to process the queue from a different location than your server

Often mentioned as “phpList cron job”

Sometimes it may be complicated to set up processing of the queue and bounces on the same server as the server that phpList lives on. There have been many attempts to find ways to call the processing from a remote location. Before version 3.1.1 all of these were “hacks”, functionality that seems to work but was never meant to work by design.

From version 3.1.1 onwards there is an option to remotely process the queue.

Get version 3.1.1

How to set up remote processing of the queue

In Config → Settings under the Security section, there will be an option called “Secret for remote processing”. The first time, it will generate a random code, which you can use, or you can set your own.

To run the queue remotely, all you need to do is load the following page:


Where the XXXX is the value that is set for the “Secret for remote processing”

Possible concerns or issues

(or Questions that will probably Frequently be Asked, QPFA or FAQ)

1. How safe is this.

Is it not easy for someone to steal my secret? Particularly when you call the parameter “secret”.

It is quite safe, but you need to determine this for yourself. The output of the page when using the remote secret is minimised to only the statistics. If an “attacker” gets hold of your secret, all they would do is help you process your queue. In fact, if you run the queue this way yourself, you will be logged out from phpList. The access with the secret is restricted to processing the queue and nothing else. We will later on extend this to processing bounces as well. In comparison, using a “username=X&password=Y” processing URL would allow anyone snooping that data to have access to your entire phpList system.

Also, if you use HTTPS, chances of someone stealing your secret are way lower.

2. What about timeouts, how long will the request last.

When run from a webpage, phpList, by default, will only run the queue processing for one minute. It will try to send as many mails as possible in that time. Then you will need to run it again.

3. Any other questions?

Use the Hosted Service now has a “secret” way to get our servers to process your queue for you. There are no payment plans and if you use this, you will help us to tweak the way it works, and in return we will process your queues without charge.

We offer this, because the last thing we'd want is that the queue processing is an obstacle for using phpList. From any point of view, but mostly performance, we advise the use of commandline processing because that is the most powerful way of sending. phpList Hosted is using commandline for everything. But in some cases this may not be an option. This is where our service hopefully fulfills a need.

To use the queue processing service sign up here

Once you signed up, get your API key.

The first time you try to manually process your queue, you will get the option to set up processing with You can use that to set up the API key.

Alternatively go to

and enter the API key.

From then on, when you place a campaign in the queue, or requeue an existing one, it will activate the processing from our servers. We will run the queue very often and make sure your campaigns are sent.

If you place an embargo on a campaign, the hosted queue processing service will detect this and wait until your embargo has passed to send your campaigns.

We do keep track of the statistics, and we will give you a summary in your account pages. The service uses the exact same system as the normal remote processing outlined above and we have no other access to your system.