# Refresh the image list
multipass find

# Set alternative image source
multipass set local.driver=qemu
Launch Failures on Specific Platforms
Windows:

Ensure Hyper-V is enabled

Run PowerShell as Administrator

macOS:

Check Virtualization support in System Information

Ensure HyperKit is properly installed

Linux:

Verify KVM support: egrep -c '(vmx|svm)' /proc/cpuinfo

Check user is in kvm group: groups $USER

Network Connectivity Issues
DNS Resolution Problems
bash
# Check DNS configuration inside instance
multipass exec <instance-name> -- cat /etc/resolv.conf

# Restart the instance to refresh network
multipass restart <instance-name>
Port Forwarding Setup
yaml
# In multipassd configuration
network:
  forward:
    - from: host:8080
      to: instance:80
Mount and Shared Folder Issues
Permission Denied Errors
bash
# Mount with proper permissions
multipass mount --uid-map $(id -u):1000 --gid-map $(id -g):1000 /local/path <instance-name>:~/mount_point
Mount Point Not Accessible
Ensure the instance is running

Check if path exists in the instance

Verify mount command syntax

Performance Optimization
Memory and CPU Allocation
bash
# Launch with specific resources
multipass launch --memory 4G --cpus 2
Disk Space Management
bash
# Check disk usage
multipass info <instance-name>

# Clean up unused instances
multipass delete <instance-name>
multipass purge
Getting Help
Gathering Logs
bash
# Collect debug information
multipass logs --latest
multipass info --all
Common Error Messages and Solutions
"Instance not found" → Verify instance name with multipass list

"Already exists" → Use different instance name or delete existing

"Permission denied" → Run with appropriate privileges

text

### **2. Updated File: `docs/index.md`**
Add this line to the documentation section:
```markdown
## Documentation
- [Troubleshooting Guide](troubleshooting.md)
- [Installing Multipass](installing.md)
- [Using Multipass](using.md)