# Mass import miners

{% hint style="success" %}
In **Roles →  Farm Permissions** admins control access by setting permissions for mass and single device imports, ensuring only authorized users can perform these actions. All import activities are logged. Access them via the **logs tab** or by selecting **"View logs"** from the miner's menu.
{% endhint %}

## Before import

1. Install MoonOne agent and scan your network.
2. Generate topology (**Settings** **→ Topology**).
3. Prepare .xlsx or .csv file to mass import.
   1. **MAC** – unique hardware address for network identification.
   2. **IP** – network address for locating and accessing the miner. 
   3. **Index** – system-generated value for managing miners, found in **Settings** → Topology
   4. **Serial Number** – manufacturer's unique ID for tracking hardware and warranty.
   5. **Submodel** – a specific variant of the miner model, indicating differences in hardware.
   6. **Client Email** – the email address associated with the owner of the miner, used for notifications and support.
   7. **Client Status** – The current operational status of the client (Paid/Unpaid).

{% file src="/files/NNndoCf2N2x5CMQOgRdj" %}
Click to download import template file
{% endfile %}

## How to mass import miners by file

1. Go to **Dashboard → Unimported**.
2. Click on **Import by file**.
3. Upload  **a file** (.xlsx or .csv) containing the following information: MAC, IP, Index, Serial number, Submodel, Client email, and Client status. 
4. Click **Apply**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fay3wuqHdkAAEzg5N1LTo%2Fuploads%2FXCqD2jq2z5lIMkEKMD4s%2FImport%20miners%203.MP4?alt=media&token=4a6f908b-b6e2-4fbf-a788-8e6692a5d5fd>" %}

{% hint style="success" %}
**Tips for Successful Bulk Import**

To maximize the success rate of your bulk miner imports, consider implementing the following best practices:

* **Consistently Verify Data:** Regularly check for data integrity and consistency before each import.
* **Adopt Incremental Imports:** If managing extremely large datasets, consider importing them in smaller batches to identify errors more easily.
  {% endhint %}

## How to mass import miners via the mass actions panel

* Go to **Dashboard → Unimported**.
* Select miners by checking relevant boxes.
* Click **Import** on the mass action panel.
* Enter the **following information:** MAC, IP, Index, Serial number, Submodel, Client email, and Client status. Max file size: 10 MB; values must follow order.
* Click **Apply**.

<figure><img src="/files/l3MyDeASw94ao3y2lFeT" alt=""><figcaption></figcaption></figure>

## How to import a single miner

To import a single device, locate the device in the Unimported list, click on the three dots next to it, and select "Import" from the dropdown menu. This option allows for individual device import without going through the bulk upload process.

## FAQ

<details>

<summary><strong>Why do I need this?</strong></summary>

Importing miners in bulk using the mass action panel streamlines data entry, reduces manual errors, and ensures all miner information is captured accurately. This method is essential for efficiently managing large volumes of miner data, thereby saving time and resources.

</details>

<details>

<summary><strong>How to resolve import failures?</strong></summary>

To address and prevent import failures, consider the following steps:

1. **Correct File Format and Size:** Confirm the file is in either .xlsx or .csv format and is under the 10 MB limit.
2. **Follow Data Order:** Ensure your data matches the specific sequence required for import.
3. **Inspect Data for Errors:** Examine your data for any missing or incorrect entries and correct them before retrying.
4. **Handle Unsupported Characters:** Remove any characters or symbols not supported by the system.

</details>

<details>

<summary><strong>How to check import logs?</strong></summary>

To track any changes made during the import process, you can view the detailed logs of all import activities. Follow these steps to access the logs:

1. Navigate to the **logs tab** on the main menu.
2. OR Select **"View logs"** from the miner's menu.

</details>

<details>

<summary><strong>Why can the system show a miner twice?</strong></summary>

If the system detects an **Antminer** (except Vnish) or **Whatsminer** with an unknown password, it can't access the MAC address — which is needed to uniquely identify the device. Without it, a duplicate may be created.

**What to do:**

Click the **key icon** on the **Dashboard**, enter the correct password, and the duplicate will be removed automatically once the MAC address is retrieved.

</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/getting-started/mass_import_miners.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.