Basilica
CLI

GPU Rentals

Raw GPU access via SSH. Browse what's available, spin one up, SSH in, do your thing.

Commands

CommandDescription
lsList available GPU instances
upStart a GPU rental
psList active rentals
statusCheck detailed rental status
logsView instance logs
downTerminate a rental
restartRestart instance container
execExecute commands on instance
sshSSH into instance
cpCopy files to/from instance

Interactive Selection

When multiple GPU options match your criteria, the CLI presents an interactive selector to choose from available offerings.

Infrastructure Sources

Filter by infrastructure source using --compute citadel or --compute bourse. See Core Concepts for details.

File Transfer Path Format

The cp command uses RENTAL_ID:/path format for remote paths:

  • Local to remote: basilica cp ./file.txt RENTAL_ID:/workspace/file.txt
  • Remote to local: basilica cp RENTAL_ID:/workspace/results.csv ./results.csv

Troubleshooting

No GPUs available

Try different GPU types, regions, or cloud types. Check The Bourse for additional availability.

SSH connection failed

  1. Check rental status with status command
  2. Verify SSH key is registered with ssh-keys list
  3. Wait 1-2 minutes for instance to be ready

File transfer slow

For large files, consider compressing before transfer or using cloud storage (S3, GCS) for large datasets.

Next Steps

On this page