# 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