Troubleshooting
This section provides solutions to common issues you may encounter when using the platform.VM Deployment Issues
Insufficient Credits
If you receive an “Insufficient Credits” error during deployment:Check Current Balance
Purchase Additional Credits
Verify Minimum Requirements
- USD: $1.00
- EUR: €1.00
- INR: ₹100.00
Retry Deployment
Resource Availability
If your selected GPU type or count is unavailable in the region:- Region Alternative
- GPU Alternative
- Timing Strategy
- Switch to NORWAY-1, CANADA-1, or US-1
- Check availability in multiple regions
- Consider latency impact of region choice
- All regions offer the same GPU types
SSH Connection Failures
If you can’t connect to your VM via SSH:VM Status Verification
VM Status Verification
- Verify that the VM is in ACTIVE state in your dashboard
- Wait for VM to fully boot (2-5 minutes after deployment)
- Check for any error states or ongoing operations
- Ensure VM has been assigned a public IP address
SSH Key Validation
SSH Key Validation
- Ensure you’re using the correct private key file
- Check private key file permissions:
chmod 600 ~/.ssh/your-key.pem
- Verify the key was properly added during VM deployment
- Test with verbose SSH output:
ssh -v -i your-key.pem user@ip
Username and Connection
Username and Connection
- Use the correct username for the OS:
- Ubuntu images:
ubuntu
- Other images:
root
or check OS documentation
- Ubuntu images:
- Verify you’re using the correct public IP address
- Ensure port 22 is open (check firewall rules)
- Try connecting from a different network/location
Network and Firewall
Network and Firewall
- Verify that port 22 is open in your security rules
- Check if your local firewall is blocking SSH
- Ensure the VM has a public IP assigned
- Test network connectivity:
ping vm-ip-address
SSH Connection Command Reference
Firewall Issues
Rule Not Taking Effect
If your firewall rules aren’t working as expected:Wait for Propagation
Verify Rule Configuration
- Correct protocol (TCP, UDP, ICMP)
- Proper port ranges
- Accurate IP address ranges in CIDR notation
- Correct direction (Ingress/Egress)
Check Firewall Attachment
- Verify attachment in firewall management
- Check VM status is ACTIVE
- Confirm firewall is in SUCCESS state
Test Connectivity
- Use telnet to test port connectivity
- Check application logs for connection attempts
- Verify from both source and destination
Cannot Delete Firewall
If you’re unable to delete a firewall:Detach First
- Detach the firewall from all VMs first
- Verify no active attachments remain
- Check attachment status in firewall details
- Wait for detachment to complete
Force Delete
- Use force delete option if available
- Contact support for stuck firewalls
- Check for hidden or failed attachments
- Verify firewall is not in transitional state
Volume Issues
Volume Attachment Failures
If you can’t attach a volume to a VM:- VM Status Check
- Regional Compatibility
- Volume Status
- System Limitations
- Ensure VM is in ACTIVE state
- Check VM is not undergoing other operations
- Verify VM has completed initial setup
- Ensure VM is not hibernated or suspended
Volume Detachment Issues
If you can’t detach a volume:VM State Requirements
VM State Requirements
- Ensure the VM is in ACTIVE state
- VM cannot be hibernated, stopped, or in transition
- Wait for any ongoing VM operations to complete
- Check VM health and responsiveness
Boot Volume Protection
Boot Volume Protection
- Cannot detach the system boot volume from running VM
- System identifies and protects critical volumes
- Check if volume is marked as bootable/system volume
- Consider stopping VM before detaching system volumes
Application Dependencies
Application Dependencies
- Applications may be actively using the volume
- Unmount volume from within the OS if possible
- Stop applications that depend on the volume
- Check for processes with open files on volume
Volume Creation Problems
If you’re having trouble creating a volume:Size Validation
- Standard volumes: minimum 10GB
- Bootable volumes: minimum 100GB
- Maximum size: 1,048,576GB (1TB)
- Size must be a positive integer
Name Uniqueness
- Check existing volumes in all regions
- Volume names must be unique across your account
- Use descriptive, meaningful names
- Follow naming conventions (letters, numbers, spaces, hyphens, underscores, periods)
OS Image Selection
- Choose from available images in your region
- Verify image compatibility with volume size
- Check regional image availability
- Ensure image is not deprecated or unavailable
Account Requirements
- Verify minimum credit balance
- Ensure account profile is complete
- Check payment method validity
- Review storage cost implications
Snapshot and Image Issues
Snapshot Creation Failure
If you’re unable to create a snapshot:VM Prerequisites
- Verify the VM is in ACTIVE state
- Ensure VM has sufficient disk space
- Check VM is not under heavy load
- Wait for any ongoing operations to complete
Account Validation
- Ensure you have a unique name for the snapshot
- Check sufficient credits for snapshot storage
- Verify account profile is complete
- Ensure no naming conflicts exist
Image Creation Issues
If you’re having trouble creating an image:Source Snapshot Validation
Source Snapshot Validation
- Verify the snapshot is in a completed/SUCCESS state
- Ensure snapshot is accessible and not corrupted
- Check snapshot has not been deleted
- Verify snapshot size and integrity
Naming and Resources
Naming and Resources
- Ensure you have a unique name for the image
- Check sufficient credits for image storage
- Verify regional availability for image creation
- Follow image naming conventions and limits
Account and Billing Issues
Can’t Purchase Credits
If you can’t buy credits:Complete Profile
- Full name and contact information
- Complete billing address
- Postal code and country selection
- Phone number (recommended)
Payment Method
- Check card details and expiration
- Ensure sufficient funds available
- Try alternative payment methods
- Check with your bank for restrictions
Minimum Purchase
- USD: $5 minimum
- EUR: €5 minimum
- INR: ₹100 minimum
Geographic Restrictions
- Verify supported countries for payments
- Check local banking regulations
- Consider alternative payment methods
- Contact support for assistance
Profile Not Complete
Make sure you have all required information:- Personal Information
- Billing Address
- Validation Steps
- Full legal name
- Valid email address (primary contact)
- Phone number (optional but recommended)
- Verify email address is confirmed
SSH Key Management Issues
Key Import Failures
If you can’t import an SSH key:Key Format Validation
Key Format Validation
- Key must be in standard OpenSSH format
- Must begin with ssh-rsa, ssh-ed25519, or ssh-dss
- Single line with no line breaks
- Include key type, key data, and optional comment
Common Format Issues
Common Format Issues
- Remove any line breaks or extra whitespace
- Ensure key isn’t corrupted or truncated
- Verify key type is supported
- Check key isn’t from unsupported source
Naming Issues
Naming Issues
- Name must be 1-50 characters
- Use only letters, numbers, underscores, hyphens, periods
- Name must be unique within your account
- Avoid special characters or spaces
Key Creation Problems
If automatic key generation fails:Browser Compatibility
- Ensure JavaScript is enabled
- Disable popup blockers temporarily
- Try a different browser
- Clear browser cache and cookies
Download Issues
- Check browser download settings
- Verify sufficient disk space
- Try right-click “Save as” if auto-download fails
- Check antivirus software interference
Alternative Generation
- Use ssh-keygen on local machine
- Import the generated public key
- Follow local key generation best practices
- Ensure proper key permissions
Getting Support
If you’re experiencing issues that aren’t resolved by the troubleshooting steps above:Email Support
- Account email address
- Detailed description of the issue
- Steps you’ve already tried
- Error messages or screenshots
- Deployment ID or VM ID if applicable
Urgent Issues
- Service outages
- Data loss concerns
- Security incidents
- Billing discrepancies
Support Checklist
When contacting support, include this information for faster resolution:- Account Information
- Issue Details
- Resource Information
- Troubleshooting
- Account email address
- Date and time when issue occurred
- Your timezone for scheduling
- Account ID or username if different from email
Common Error Codes
Understanding error codes can help you troubleshoot issues more effectively:Authentication Errors
Authentication Errors
Resource Errors
Resource Errors
Network Errors
Network Errors
Storage Errors
Storage Errors