---
title: "Creation and Management"
canonical_url: "https://docs.hashcore.com/en/pulse/agents/create-scan-task"
---
# Creation and Management

## Creating a Scan Task `v0.1.0`

1. Go to **Agents** → select the desired agent
2. Open the **Scan Tasks** tab
3. Click **+ New Task**
4. Enter a **task name** — use a clear name (e.g., "Subnet 192.168.1.x" or "Hall B")
5. In the **Network ranges** section, click **Add IP range**
6. Specify the start and end IP address of the range (e.g., `192.168.1.1` — `192.168.1.254`)
7. Add more ranges if necessary
8. Configure **Unlock Configs** if devices are password-protected
9. Click **Create**

![](https://docs.hashcore.com/images/pulse/agents/41306f59-6c29-80e6-9dc6-d6db4acb4549.png)

## Adding IP Ranges

### Manual Entry `v0.1.0`

Click **Add IP range** and manually enter the start and end addresses of the range. Smart paste (`v0.5.0`) — when pasting from the clipboard, the system automatically detects the format and fills the required number of fields:

- Single address (e.g., `192.168.1.50`) — fills 4 octet fields
- Range with a hyphen (e.g., `192.168.1.1-192.168.1.254`) — fills 8 fields

### Renaming Ranges `v0.7.0`

Each range can be given a name — open the range's **⋮** menu and select **Rename range**. The name is displayed in the list of ranges and simplifies navigation.

![](https://docs.hashcore.com/images/pulse/agents/41306f59-6c29-801d-a4ae-d528a9033918.png)

### Enabling and Disabling Ranges `v0.7.0`

Each range can be temporarily disabled without deleting it — use the **Enable** toggle in the range's **⋮** menu. Disabled ranges are not scanned by the agent, but they remain saved in the task.

## Unlock Configs — Credentials for Unlocking `v0.2.0`

If devices are protected by non-standard passwords, the agent will not be able to retrieve metrics from them without authorization. Credentials can be saved for each firmware type. MicroBT (Whatsminer) support was added in `v0.7.0`, and default device passwords hardcoded in the agent were removed in `v0.8.0`:

<table>
<thead>
  <tr>
    <th>
      Firmware Type
    </th>
    
    <th>
      Configurable Items
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <strong>
        HashCore (Vnish)
      </strong>
    </td>
    
    <td>
      Three passwords: First, Second, and Third password
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Bitmain (Stock)
      </strong>
    </td>
    
    <td>
      Login and password (default root / root)
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        MicroBT (Whatsminer)
      </strong>
    </td>
    
    <td>
      Login and password
    </td>
  </tr>
  
  <tr>
    <td>
      <strong>
        Avalon
      </strong>
    </td>
    
    <td>
      Login and password
    </td>
  </tr>
</tbody>
</table>

Saved credentials are used automatically by the agent during scanning.

If a device is already discovered but locked — this tab can be opened directly by clicking the lock tag in the device list, see section **Device List → Contextual Unlocking**.

![](https://docs.hashcore.com/images/pulse/agents/41306f59-6c29-80db-add4-e4e1698a041a.png)

## Managing Tasks

### Enabling and Disabling a Task `v0.3.0`

In the task's context menu, use the **Enable** toggle. When a task is disabled, the agent stops scanning the specified ranges, but the task and all ranges are preserved.

### Editing a Task

Click **Edit scan task** in the task's context menu to change the name, ranges, and Unlock Configs.

### Deleting a Task

Click **Remove scan task** in the context menu. A deleted task cannot be recovered.

**As of v1.0.0-alpha1:** when a Scan Task is deleted, all devices discovered through it are removed from the system (they do not transition to Offline). Before deletion, a dialog appears showing the number of affected ranges and devices, along with a confirmation checkbox. This behavior differs from deleting an individual IP range within a task — a range transitions devices to Offline without deleting them.


## Sitemap

See the full [sitemap](https://docs.hashcore.com/sitemap.md) for all pages.
