VM Commands
Create and manage SSH-accessible virtual machines with CPU or GPU hardware.
Commands
| Command | Description |
|---|
lyceum vm start | Create a new VM |
lyceum vm list | List all your VMs |
lyceum vm availability | Show available hardware profiles |
lyceum vm status | Get VM details |
lyceum vm terminate | Delete a VM |
lyceum vm start
Create a new virtual machine with SSH access.
lyceum vm start --hardware-profile <profile> --key "<ssh_public_key>"
Options
| Option | Description |
|---|
--hardware-profile | (required) Hardware type: cpu, gpu, a100, h100, b200 |
--key | (required) SSH public key for root access |
Hardware Profiles
| Profile | GPU | VRAM | RAM |
|---|
cpu | None | — | 16 GB |
gpu | NVIDIA T4 | 16 GB | 4 GB |
a100 | NVIDIA A100 | 40 GB | 200 GB |
h100 | NVIDIA H100 | 80 GB | 180 GB |
b200 | NVIDIA B200 | 180 GB | 184 GB |
Examples
# Start an A100 VM
lyceum vm start --hardware-profile a100 --key "$(cat ~/.ssh/id_rsa.pub)"
# Start an H100 VM
lyceum vm start --hardware-profile h100 --key "$(cat ~/.ssh/id_ed25519.pub)"
# Start a CPU-only VM
lyceum vm start --hardware-profile cpu --key "$(cat ~/.ssh/id_rsa.pub)"
╭───────────────────── VM Created ─────────────────────╮
│ VM ID: vm_abc123 │
│ Hardware: A100 (40GB VRAM) │
│ IP: 192.168.1.100 │
│ SSH: ssh root@192.168.1.100 │
╰──────────────────────────────────────────────────────╯
VM provisioning can take up to 10 minutes depending on hardware availability.
lyceum vm list
List all your virtual machines.
Shows for each VM:
- VM ID
- Hardware profile
- Status
- IP address
- Creation time
lyceum vm availability
Check which hardware profiles are currently available.
Shows available hardware profiles with pricing information.
Run this before starting a VM to ensure your desired hardware is available.
lyceum vm status
Get detailed information about a specific VM.
Arguments
| Argument | Description |
|---|
vm_id | (required) VM ID to check |
Output
Returns:
- VM ID
- Hardware profile
- Status (pending, running, terminated)
- IP address
- SSH command
- Uptime
- Cost so far
Examples
lyceum vm status vm_abc123
lyceum vm terminate
Delete a virtual machine.
lyceum vm terminate <vm_id>
Arguments
| Argument | Description |
|---|
vm_id | (required) VM ID to terminate |
Options
| Option | Description |
|---|
--force | Skip confirmation prompt |
Examples
# Terminate with confirmation
lyceum vm terminate vm_abc123
# Terminate without confirmation
lyceum vm terminate vm_abc123 --force
Terminating a VM is permanent. All data on the VM will be lost. Save important files to Storage before terminating. Typical Workflow
# 1. Check available hardware
lyceum vm availability
# 2. Start a VM
lyceum vm start --hardware-profile a100 --key "$(cat ~/.ssh/id_rsa.pub)"
# 3. Connect via SSH (use IP from output)
ssh root@<ip-address>
# 4. Do your work on the VM...
# 5. Terminate when done
lyceum vm terminate <vm_id>
Billing
VMs are billed per second of uptime. Billing starts when the VM reaches running status and stops when you terminate it.
Check your current costs with:
