# Renter Troubleshooting

Common issues and solutions when renting GPU servers on Clore.ai.

## Server Connection Issues

### Cannot Connect via SSH

**Symptoms:** Connection refused, timeout, or permission denied.

**Solutions:**

1. **Wait for server to boot**
   * New orders take 2-5 minutes to fully initialize
   * Check order status in "My Orders" - should show "Running"
2. **Verify connection details**
   * Double-check IP address and port from order details
   * Use the exact command format: `ssh root@IP -p PORT`
3. **Check your network**
   * Try from a different network (some ISPs block certain ports)
   * Use Clore VPN if available in your region
4. **SSH key issues**
   * Ensure your public key is added in Account → SSH Keys
   * Try password authentication if keys don't work

### Server Not Responding

**Symptoms:** Server was working but now unresponsive.

**Solutions:**

1. **Check server status** in My Orders
2. **Wait 5-10 minutes** - server may be restarting
3. **Contact host** via chat if issue persists
4. **Request refund** if server is completely unavailable

## GPU Issues

### GPU Not Detected

**Symptoms:** `nvidia-smi` returns error or shows no GPUs.

**Solutions:**

```bash
# Check if NVIDIA driver is loaded
lsmod | grep nvidia

# Restart NVIDIA services
sudo systemctl restart nvidia-persistenced

# Check for driver issues
dmesg | grep -i nvidia
```

If GPU still not detected:

1. Contact the host via order chat
2. Request server restart through support
3. Consider ending order and finding different server

### CUDA Errors

**Symptoms:** CUDA out of memory, version mismatch errors.

**Solutions:**

1. **Check CUDA version compatibility**

   ```bash
   nvcc --version
   nvidia-smi
   ```
2. **Free GPU memory**

   ```bash
   # Find processes using GPU
   nvidia-smi

   # Kill specific process
   kill -9 <PID>
   ```
3. **Use appropriate Docker image** with matching CUDA version

### GPU Performance Lower Than Expected

**Solutions:**

1. Check if other processes are using GPU: `nvidia-smi`
2. Verify GPU model matches listing
3. Monitor GPU utilization during your workload
4. Contact host if specs don't match advertised

## Docker / Container Issues

### Container Won't Start

**Solutions:**

1. **Check Docker status**

   ```bash
   docker ps -a
   docker logs <container_id>
   ```
2. **Restart Docker service**

   ```bash
   sudo systemctl restart docker
   ```
3. **Check disk space**

   ```bash
   df -h
   ```

### Missing Dependencies

**Solutions:**

1. Install required packages:

   ```bash
   apt-get update && apt-get install -y <package>
   ```
2. Use pip for Python packages:

   ```bash
   pip install <package>
   ```
3. Consider using a different Docker image with pre-installed tools

## Network Issues on Server

### Cannot Access Internet from Server

**Solutions:**

1. **Check DNS**

   ```bash
   cat /etc/resolv.conf
   # Try adding Google DNS
   echo "nameserver 8.8.8.8" >> /etc/resolv.conf
   ```
2. **Test connectivity**

   ```bash
   ping 8.8.8.8
   curl -I https://google.com
   ```

### Ports Not Accessible

Some servers have firewall restrictions:

1. Check which ports are open in order details
2. Use SSH port forwarding for services
3. Contact host if you need specific ports opened

## Billing Issues

### Charged More Than Expected

1. Check order history for actual usage duration
2. Review fee structure (On-Demand vs Spot rates)
3. Account for creation fees
4. Contact support with order ID if discrepancy exists

### Order Terminated Unexpectedly

**For Spot orders:**

* Another user may have outbid you
* This is normal for Spot rentals
* Use On-Demand for guaranteed access

**For On-Demand orders:**

* Check if balance was sufficient
* Review order logs for termination reason
* Contact support if unclear

## Getting Help

### Contact Host

* Use the chat feature in your order details
* Hosts typically respond within a few hours

### Clore.ai Support

* Discord: [discord.gg/clore-ai](https://discord.gg/clore-ai)
* Use #support channel for technical issues

### Request Refund

If server doesn't meet advertised specs:

1. Document the issue (screenshots, logs)
2. Contact host first
3. If unresolved, contact Clore.ai support with evidence


---

# 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.clore.ai/for-renters/renter-troubleshooting.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.
