A task failed in the panel: read the error and retry it
On this page
Every change the panel makes on the server — creating an account, a mailbox, a certificate, a backup — runs as a task, carried out by the panel's background agent (sahaabd). When one fails, the task keeps its output and its error, and an administrator can run it again.
Symptoms
- A task shows Failed in Task Queue.
- The Dashboard lists failed tasks of the last 24 hours.
- Something you changed did not happen (a mailbox does not work, a website setting is not applied), or a page says "The server could not complete the request: …".
Causes
Most likely first:
- A temporary condition — a service restarting, the package manager busy, a network time-out.
- Something on the server is not as the task expects — a folder missing or owned by someone else, a full disk, a name that already exists.
- An outside service failed — the certificate authority, a backup destination, a download.
- A fault in the panel itself.
Fix
Read the error
- Open Task Queue in the admin panel (
https://<server>:2087) and click Failed to list only failed tasks. - Click the task number. The page shows the task type (for example
ssl.issueoraccount.create), who started it, when it was Queued, Started and Finished, the Attempts, the Payload (what it was asked to do) and the Output. - The last line of Output starting with
ERROR:is the reason. The lines above it show the commands that ran before it.
If the AI assistant is turned on (Server Settings → AI assistant), click Explain with AI for an explanation in plain words, or Fix with the assistant: the assistant looks at the server, proposes what to change and does it only after you confirm.
1. Temporary condition
Click Retry. The task runs again with the same details, including a password it carried.
2. Something on the server
Fix what the error names, then click Retry. Common ones:
No space left on device: free disk space on the server (Server Status shows the disks).Could not get lock /var/lib/dpkg/lock-frontend: system updates are running; retry when they finish.… already exists: something with that name was made outside the panel or by an earlier attempt; remove or rename it first.
3. Outside service
For certificates, the error is the authority's message (the domain does not point here, rate limit). For backups to external storage, use Test connection on the destination. Retry once it is fixed.
4. A fault in the panel
If the error is not about the server or an outside service, the panel sends an error report automatically (when Send error reports is on in Server Settings), with customer data removed. Install fix releases under Updates, then retry.
Good to know
- Only administrators see Retry, Explain with AI and Fix with the assistant. Resellers see the task list.
- Customers do not see tasks; their pages show the result or the error of what they did.
- Completed tasks are removed after 30 days. Failed tasks stay until they are retried.
- With webhooks,
task.failedcan notify your own systems.
Still not working?
If tasks do not start at all (they stay Queued), see Tasks stay queued.
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" and changes are not applied
The panel warns that tasks have been waiting over 2 minutes and nothing you change takes effect. Check and restart the background agent sahaabd on the server.
- Panel update failed: what happened and what to do
A control panel update stopped with an error. Read the update log, see what was rolled back automatically, then update again or restore the snapshot.
- Disk quota exceeded: hosting account disk space full
Uploads fail with "Disk quota exceeded" or you got a "Disk space full" email. See what takes the space in your account and how to free it or get more.