Learn the complete VM lifecycle on Massed Compute with automated provisioning, configuration, verification, and teardown workflows. This guide shows you how to prevent billing leaks, secure data cleanup, and manage GPU instances efficiently through the API.
This workflow exists as a machine-readable recipe in the Massed Compute MCP. Skip the manual steps and deploy with an AI agent in seconds.
Every Massed Compute session follows the same path: select a profile, launch (or reuse) a VM, do project work, download artifacts, wipe remote cache/data, terminate billing, and reset local handoff files—without mixing UUIDs or leaving GPUs running idle.
This lifecycle management approach prevents orphan VMs, secures data cleanup, and ensures cost-effective GPU usage across all workloads from MusicGen to ComfyUI.
| Component | Purpose | Version |
|---|---|---|
| Massed Compute API | VM provisioning & termination | v1 |
| Ubuntu 24.04 | Base OS | Latest |
| SSH | Remote configuration | OpenSSH |
| API Credentials | Authentication | Bearer Token |
| Requirement | Specification |
|---|---|
| Operating System | Ubuntu 24.04 |
| Minimum vCPUs | 2 cores |
| Minimum RAM | 4 GB |
| API Access | Massed Compute credentials |
| Network | SSH access (port 22) |
Massed Compute VM Pricing
The VM configurations matching this lifecycle guide’s requirements were not available in our pricing snapshot from July 7, 2026. For current pricing on Ubuntu 24.04 VMs with 2+ vCPUs and 4+ GB RAM, check live pricing.
VM Lifecycle Deployment
Audit Running Instances
Before starting any new work, audit what VMs are currently running to prevent billing leaks and resource conflicts.
# List all running instances
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
https://vm.massedcompute.com/api/v1/instances
Terminate any instances you’re not actively using to avoid unnecessary charges.
Select VM Profile
Choose the appropriate VM profile based on your workload requirements. Common profiles include:
gpu-basic– Standard GPU workloads (ComfyUI, MusicGen)cpu-dev– Development and testinggpu-training– ML model training
Verify your profile configuration matches the intended VM specifications.
Launch VM Instance
Provision a new VM using the Massed Compute API with your selected profile.
# Launch VM with specific configuration
curl -X POST -H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "lifecycle-test",
"image": "ubuntu-24.04",
"instance_type": "gpu-basic",
"ssh_key": "your-public-key"
}' \
https://vm.massedcompute.com/api/v1/instances
Poll the instance status until it shows running before proceeding to SSH configuration.
Configure and Verify
Run your project-specific configuration steps on the VM. Confirm handoff file exists and UUID matches the intended VM before making changes.
# SSH into the VM
ssh ubuntu@YOUR_VM_IP
# Run project setup commands
sudo apt update && sudo apt upgrade -y
# Install project dependencies...
Complete your workload (AI training, image generation, etc.) and verify all artifacts are created successfully.
Download Artifacts
Before teardown, download all important files to your local machine. Different workloads generate different artifact types:
| Workload | Artifacts to Download |
|---|---|
| ComfyUI | Generated images, workflows, custom models |
| MusicGen | Generated audio files (.wav) |
| Custom Training | Model checkpoints, logs, datasets |
# Download files using SCP
scp -r ubuntu@YOUR_VM_IP:/path/to/outputs ./local-outputs/
Complete Teardown
Perform full teardown including remote cleanup, VM termination, and local reset to prevent data exposure and billing leaks.
# Remote cleanup (via SSH)
# - Stop services (ComfyUI, etc.)
# - Delete output directories, temp files
# - Clear caches (HuggingFace, PyTorch, pip)
# - Keep model checkpoints (expensive to re-download)
# Terminate VM via API
curl -X DELETE -H "Authorization: Bearer YOUR_API_TOKEN" \
https://vm.massedcompute.com/api/v1/instances/YOUR_INSTANCE_ID
# Reset local connection metadata
# Clear SSH host keys for recycled IPs
Verify teardown completed successfully by confirming the VM no longer appears in your running instances list.
Troubleshooting
Wrong Profile/UUID Mismatch
If SSH connects to the wrong host, you have a UUID mismatch. Re-read your profile matrix and verify the correct connection metadata.
Protected VM Prevention
Some VMs are marked as protected to prevent accidental termination. Check the protected instance registry before teardown and only override with explicit user confirmation.
Recycled IP Address
When Massed Compute reuses public IPs, you may get SSH host key warnings. Refresh SSH host keys during teardown with the --clear-ssh-host option.
Incomplete Artifact Download
Always verify artifacts are downloaded before remote cleanup. Once the VM is terminated, all data on the instance is permanently lost.
Skip All of This: Deploy with an AI Agent
This entire VM lifecycle workflow exists as a tested, machine-readable recipe in the Massed Compute MCP (Model Context Protocol). Instead of running commands manually, configure an AI agent to handle the complete provisioning, configuration, verification, and teardown process.
Add this configuration to your MCP client:
{
"mcpServers": {
"massed-compute": {
"type": "http",
"url": "https://vm.massedcompute.com/api/mcp",
"headers": { "Authorization": "Bearer MC_TOKEN" }
}
}
}
Then say:
The agent matches your request against this recipe (tested on June 10, 2026), provisions the right VM shape, runs the setup and verification steps above, and reports back with the result. It stops automatically if any step fails to prevent billing leaks or data loss.
Quick Setup Guide
For rapid deployment, follow this condensed workflow:
- Audit: List running instances and terminate unused VMs
- Launch: Provision VM with your required specifications
- Configure: SSH in and run project setup commands
- Work: Complete your ML training, image generation, or other workload
- Download: Copy all artifacts to local storage before cleanup
- Teardown: Clean remote data, terminate VM, reset local metadata
This workflow prevents the most common pitfalls: orphan VMs running up bills, data left exposed on terminated instances, and mixed UUIDs causing configuration errors.
Frequently Asked Questions
01 What happens if I forget to download artifacts before termination?
All data on the VM instance is permanently lost when terminated. There’s no recovery option, so always verify artifact downloads are complete before running teardown commands.
02 Should I delete model checkpoints during cleanup?
By default, the lifecycle keeps model checkpoints because they’re expensive to re-download. Only use the delete-models option when you intentionally want to free disk space and don’t mind re-downloading large model files.
03 How do I handle protected VMs in my teardown workflow?
Protected VMs require explicit user override to prevent accidental termination of important instances. Check the protected instance registry before teardown and only override when you’re certain the VM should be terminated.
04 What causes SSH host key warnings on Massed Compute?
Massed Compute reuses public IP addresses, so you may connect to a different VM than expected. Use the clear-ssh-host option during teardown to refresh SSH host keys and prevent warnings on future connections.
05 Can I run multiple workloads on the same VM instance?
Yes, but use profile-specific JSON files to avoid UUID conflicts. Each workload type (MusicGen, ComfyUI, etc.) should have its own connection metadata file to prevent configuration mixing and ensure proper cleanup.











