# Troubleshooting & FAQ

### **Overview**

The **Troubleshooting and FAQ** section provides miners with quick solutions to common technical issues encountered during setup or operation of the HashCloud system.\
By addressing driver conflicts, verification errors, and performance issues, this section helps maintain consistent uptime and optimal compute performance across all hardware tiers.

<details>

<summary>❓ GPU Not Detected</summary>

**Symptoms:**\
The HashCloud client (`HCLD-cli`) does not recognize any available GPUs.

**Possible Causes:**

* Outdated or missing GPU drivers
* Incorrect CUDA / ROCm installation
* Hardware detection issues after system updates

**Solution:**

* Update to the latest GPU drivers.
* Reboot your system.
* Verify that **CUDA (NVIDIA)** or **ROCm (AMD)** is correctly installed.
* Confirm that your OS has proper GPU permissions for the mining process.

</details>

<details>

<summary>❓ “VRAM Exceeds VIP Tier”</summary>

**Symptoms:**\
The backend rejects mining authorization with a VRAM mismatch warning.

**Possible Causes:**

* The GPU has more VRAM than allowed by the current VIP level.
* Configuration file references more GPUs than permitted under your tier.

**Solution:**

* Upgrade your **VIP tier** to unlock additional GPU or VRAM capacity.
* Alternatively, reduce the GPU count or select compliant hardware per tier (see Section 9: Hardware Tiering).

</details>

<details>

<summary>❓ Backend Rejecting Proofs</summary>

**Symptoms:**\
The backend server consistently rejects proof submissions.

**Possible Causes:**

* Local clock desynchronization
* Network latency or expired challenge windows
* Invalid computation or altered proof packets

**Solution:**

* Sync your system clock with a reliable **NTP server**.
* Ensure your internet connection is stable.
* Confirm that challenges are executed and submitted before expiration.
* Restart the miner if the issue persists, as it may refresh expired sessions.

</details>

<details>

<summary>❓ Performance is Low</summary>

**Symptoms:**\
Mining output or performance scores appear below expected levels.

**Possible Causes:**

* GPU underclocking or thermal throttling
* Oversized matrix computation relative to GPU capability
* Background applications consuming GPU resources

**Solution:**

* Lower matrix size manually using **local configuration mode**.
* Monitor GPU temperatures and fan speed to avoid thermal throttling.
* Close unnecessary background applications.
* Run a benchmark test (`HCLD-cli benchmark`) to recalibrate difficulty.

</details>

<details>

<summary>❓ Miner Crashes</summary>

**Symptoms:**\
The mining client stops responding or closes unexpectedly.

**Possible Causes:**

* Memory leaks or unstable GPU overclocks
* Driver conflicts or failed updates
* Incomplete installation of required dependencies

**Solution:**

* Run the built-in diagnostic mode:

  ```
  HCLD-cli diagnose
  ```
* Review the generated report for driver or dependency errors.
* Reinstall the HashCloud **CLI** or update GPU drivers.
* Use default GPU clock settings for stable operation.

</details>

### **Additional Support Resources**

If issues persist, miners can access official support channels:

* **Community Discord:** Real-time help and configuration advice from moderators and veteran miners.
* **Documentation Portal:** Technical setup guides, driver troubleshooting, and performance optimization tutorials.
* **Email Support:** Direct contact with the HashCloud technical team for advanced diagnostics.

### **Best Practices for Stability**

To maintain continuous uptime and efficiency:

* Regularly update the mining client and dependencies.
* Avoid overclocking beyond stable GPU thresholds.
* Periodically benchmark and calibrate difficulty levels.
* Monitor system logs for unusual compute activity.

Following these guidelines ensures reliable performance and contributes to the network’s overall compute integrity.


---

# 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://docs.hashcloud.sh/installation-guide/troubleshooting-and-faq.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.