# Maintenance tasks

{% hint style="success" %}
To access workflow and task type settings, you’ll need a **Scale** or **Enterprise** plan.
{% endhint %}

## Configuring the Maintenance Task Workflow

Before using the Maintenance Task Manager, go to **Settings > Task manager settings > Workflows** and click **Edit** next to **Maintenance task workflow**.

On the first page, you can edit the workflow description so that other users understand its purpose. Then click Save and Continue.

On the second page, a default maintenance workflow is available. You can customize the workflow itself and edit the list of custom fields (learn more about workflow editing here: ).

The task type is automatically linked to the default workflow. Therefore, in the task manager selector at the top of the site, you’ll see Maintenance Tasks listed as a manager option.

## Automatic task creation

Tasks are created automatically when miner malfunctions are detected (statuses such as O*ffline, Hanged, Lowhash,* etc.).\
**Auto-create tasks** is enabled when the **Auto reboot** feature is active in **Settings > Automation** for the configured device models.

**Common trigger reasons include:**

* Device status: **Offline**
* Device status: **Hanged**
* Device status: **Lowhash** (low hashrate)
* Board hashrate drop of 15% or more
* Board hashrate = 0
* Board hashrate = unknown
* Fan error (0 rpm, 30600 rpm, or no data)
* Unknown reason
* And others

## Manual task creation

If a malfunction isn’t automatically detected, if **Auto reboot** is disabled, or if the issue isn’t device-related, users can create maintenance tasks manually.

### To create a task for a device:

1. Go to **Dashboard**.
2. Click on the **three dots** next to the miner.
3. Select **Create task**.
4. In the dropdown, choose **Maintenance tasks**.
5. Fill in the required fields in the modal window.
6. Click **Save**.
7. The task will appear in the **Maintenance tasks manager**, in the first workflow status column/accordion, along with a pop-up notification showing the **Task ID**.

You can also enable automatic reason detection by selecting Auto-detect in the Reason field before saving. Once created, open the task in the manager to see the auto-detected cause (if no issue is found, it will show Unknown).

Hovering over the wrench icon next to a miner displays a tooltip with current information about the related task.

### To create a new task directly in the manager:

1. Click **+** or **Create Task** if there are no existing tasks.
2. Fill in the required fields in the modal.
3. Click **Save**.
4. The new task will appear in the first workflow column/accordion with a confirmation pop-up and **Task ID**.

## Task creation blockers

Automatic task creation is blocked if:

* Device is in **Sleep mode**
* Device is in **Low power** **mode**
* All devices at the site are **Offline**
* Device is undergoing **tuning**
* Device is **overheating** (status: Overheated)
* Another active task exists for the same device in statuses like *To Do*, *In Progress*, or *Done*

If necessary, you can still manually create a task in the Maintenance tasks manager and link the device as an asset.

## How the maintenance tasks manager works

The manager offers two display modes: **Board** and **List**, selectable via the interface view switcher.

**Board view:**

* Columns represent workflow statuses.
* Tasks can be moved between columns using **drag-and-drop**.
* Each column shows a task counter for that status.

**List view:**

* Tasks are shown in a table grouped by status accordions, including **Archive**.
* Accordions can be expanded or collapsed.
* Task counters appear in each accordion header.

## Available settings

In the task manager interface, you can access **Task manager settings**. For maintenance tasks, the relevant options are:

* **Archiving settings** — define how long after completion (*Done*) a task is moved to *Archive* (archived tasks can’t be edited or deleted).
* **Service centers** — create partner service centers to handle device or component tickets during diagnostics.
* **Component statuses** — create and assign component statuses for diagnostics and maintenance.
* **Reasons** — define custom reasons for different task types, including maintenance.

Filters and search are available:

* **Filters** display tasks that match specific parameters.
* **Search** helps locate tasks by task attributes or linked device/asset parameters.

## Task fields

Each task card or row displays:

* **ID**
* **Short description (Title)**
* **Reason**
* **Device Index**
* **Due Date**
* **Assignee**
* **Priority**
* **Action menu**

When creating or editing a task, the following fields are available:

* **ID** — auto-generated, visible only in edit mode.
* **Information tab:**
  * **Device details (two blocks)**:
    * **Index**
    * **Serial Number**
    * **MAC Address**
    * **Model**
    * **Client**
    * **Worker**
  * **Task details:**
    * **Reason** — rpurpose or cause of the task.
    * **Priority** — urgency level (*Trivial → Critical*, default: *Medium*).
    * **Status** — locked at creation (default: *To Do*), editable when updating.
    * **Reporter** — user who created the task (non-editable).
    * **Assignee** — responsible staff member.
    * **Due date** — future completion date.
    * **Creation date** — the date the task was created.
    * **Last updated date** — the date the task was last edited.
  * **Custom fields**
  * **Task description**
  * **Related tasks section** — here, you can create related tasks under other managers with different workflows. All related tasks appear in the parent and child task tables. When creating a related task, device and asset data are inherited automatically.
* **Assets tab** — contains a search field for attaching existing assets and a table listing linked ones. Available if the **Asset manager** feature is enabled.
* **Diagnostics tab** — includes **Data at task creation** and **Diagnostics & Repairs** sections where you can view the device state at task creation, run diagnostics, and manage repairs.\
  Available only for tasks created from the Dashboard.
* **Comments / Logs** — available in all tabs.

### FAQ

<details>

<summary>When are maintenance tasks created automatically?</summary>

When issues are detected, such as offline status, hangs, or low hashrate.

</details>

<details>

<summary>What do I need to enable automatic task creation?</summary>

Turn on the **Auto-reboot** feature for supported models in **Automation** settings.

</details>

<details>

<summary>Why might tasks not be created?</summary>

Tasks are blocked if the device is in sleep mode, tuning, or overheating.

</details>

<details>

<summary>Can I create a maintenance task manually?</summary>

Yes, you can create a task with either a default reason or a custom one.

</details>

***

#### We're always available! <a href="#were-always-available" id="were-always-available"></a>

Chat with us on [Telegram](https://t.me/moondmc_bot).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.moonone.online/task-managers/maintenance-tasks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.