How to find and retry a failed task (Task Queue)
On this page
Every change the control panel makes on the server — creating an account, issuing a certificate, installing PHP — runs as a task, carried out by the background agent sahaabd. When something did not work, the task tells you why.
See the tasks
- Log in to the administrator panel (
https://<server>:2087). - Open Task Queue in the menu.
- Use the buttons All, Queued, Running, Done and Failed to filter. Click Failed to see only what went wrong.
Each row shows the task number, the task type (for example account.create), the status, who started it (By, or system for automatic tasks), the number of Attempts, and when it was queued and finished.
Read why a task failed
- Click the task number.
- The task page shows Queued, Started, Finished and Attempts, the Payload (what the task was asked to do; secrets are hidden) and the Output with the error.
Run a failed task again
- Correct the cause if you can (for example free disk space, or point a domain to the server).
- On the task page, click Retry.
The task goes back into the queue and runs within seconds. Reload the page to see the new result.
Get help understanding the error
When the AI assistant is turned on in Server Settings, a failed task also has the buttons Explain with AI (an explanation of the output) and Fix with the assistant.
Good to know
- The dashboard shows how many tasks failed in 24h.
- The list shows the latest 200 tasks. Finished tasks are deleted after 30 days.
- If the agent restarts while a task is running, the task is marked failed with
Interrupted: agent restarted. Retry it. - Resellers see only the tasks they started, and cannot retry them.
- To be told about failed tasks in another system, use the webhook event
task.failed; see webhooks.
Common questions
Tasks are not failing, they just stay "queued". Why?
The agent is not running. See tasks stay queued.
Can I retry a task that is done?
No. Retry is only shown for failed tasks. To repeat a finished change, do it again from its page in the panel.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- Tasks stay queued: the agent (sahaabd) is not running
Changes do not happen and the panel says tasks have been waiting over 2 minutes? Check and restart the sahaabd agent that carries out every task.
- How to see who changed what: the Activity Log
The Activity Log lists the latest 300 actions on the server with time, user, IP address and details. Filter it by user, action, IP or text.
- The admin dashboard explained: what each number means
What the administrator dashboard shows: accounts, domains, tasks, server load, memory, disk, websites that are down and new versions.
- Webhooks explained: notify other systems of server events
Send a signed JSON message to your billing, monitoring or chat system when accounts, domains, mailboxes, limits, tasks or tickets change.