Back to Documentation

Troubleshooting

Common issues and their solutions

Common Issues

Wallet Connection Issues

Problem: Cannot connect wallet

  • Make sure your wallet extension is installed and unlocked
  • Try refreshing the page
  • Check that your wallet supports Solana
  • Verify you're on a supported network (mainnet/devnet)

Worker Installation Issues

Problem: Installation fails

  • Verify NVIDIA drivers are installed: nvidia-smi
  • Check you have sudo/root access
  • Ensure internet connection is stable
  • Check system logs: sudo journalctl -u capa-worker

Machine Not Appearing

Problem: Machine not in pending list

  • Verify worker is running: sudo systemctl status capa-worker
  • Check Account ID matches in worker config
  • Verify worker can reach API: curl https://capa.cloud/api/worker/register
  • Check worker logs for errors

SSH Connection Issues

Problem: Cannot connect via SSH

  • Verify SSH key permissions: chmod 600 key.pem
  • Check SSH port is correct
  • Verify rental is still active
  • Test connection: ssh -v username@host -p port

Balance Issues

Problem: Cannot rent GPU - insufficient balance

  • Check your account balance on the Account Balance page
  • Top up your balance before renting
  • Ensure balance covers at least 1 hour of rental
  • Wait for top-up transaction to confirm

Checking Worker Status

Use these commands to diagnose worker issues:

Check Service Status

sudo systemctl status capa-worker

View Logs

sudo journalctl -u capa-worker -f

Check GPU

nvidia-smi

Check Docker

sudo systemctl status docker
docker ps

Getting Help

If you can't resolve an issue:

Contact Support

When contacting support, include:

  • Error messages
  • Relevant logs
  • Steps to reproduce