How to find and retry a failed task (Task Queue)

For server administrators · Updated 2026-10-29

On this page
  1. See the tasks
  2. Read why a task failed
  3. Run a failed task again
  4. Get help understanding the error
  5. Good to know
  6. Common questions

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

  1. Log in to the administrator panel (https://<server>:2087).
  2. Open Task Queue in the menu.
  3. 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

  1. Click the task number.
  2. 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

  1. Correct the cause if you can (for example free disk space, or point a domain to the server).
  2. 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.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.