Nodes
Node are currently in early access.
We offer two kinds of nodes: Reserved and Auto Reserved Nodes. Once provisioned, you can run VMs on them.
Reserved Nodes
Reserved Nodes are nodes that you've paid to reserve for a specific duration. Once provisioned, reserved nodes are guaranteed during your allotted interval.
Use the Nodes API to manage reserved nodes programmatically.
To create a reserved node, you'll need to install the sf CLI and setup a startup script for your VMs.
# Create a reserved node with specific start/end times
sf nodes create cuda-crunch --zone hayesvalley --start "2024-01-15T10:00:00Z" --end "2024-01-15T12:00:00Z" --max-price 10.00
# Create a reserved node for 2 hours starting now
sf nodes create cuda-crunch --zone hayesvalley --duration 2h --max-price 10.00
# Create a reserved node starting in 1 hour for 6 hours
sf nodes create cuda-crunch --zone hayesvalley --start "+1h" --duration 6h --max-price 10.00
If you'd like to hold onto a reserved node for a longer period, you can extend it.
# Extend a reserved node by 1 hour for $10.00 per node hour
sf nodes extend cuda-crunch --duration 1h --max-price 10.00
View all your nodes with:
sf nodes list
Auto Reserved Nodes
Auto Reserved Nodes are best if you are flexible about the timing and duration assigned to your VMs.
Use the Nodes API to manage auto reserved nodes programmatically.
To create an auto reserved node, you'll need to install the sf CLI and setup a startup script for your VMs.
# Create an auto reserved node with a max price of $10 per node hour
sf nodes create cuda-crunch --zone hayesvalley --max-price 10
# Create 3 auto reserved nodes with a max price of $10 per node hour
sf nodes create -n 3 --zone fishermanswharf --max-price 10
Once created, we will continually bid to rent GPUs at or below your max price. If successful, a VM will be provisioned on the node to run your workload.
If the market price exceeds your max price, any running VM will be terminated (at the end of your allotted time) but the node will remain active and continue to wait for the market price to drop and provision a new VM.
You can view all your auto reserved nodes with:
sf nodes list --verbose
Node: cuda-crunch
ID: n_0d2f72f0b631b674
Type: Auto Reserved Node
Status: Released
GPU: H100
Zone: hayesvalley
Owner: sfcompute-com
📅 Schedule:
Start: 2025-08-04 19:03:09 UTC
End: 2025-08-07 15:50:24 UTC
Duration: 68 hours
💰 Pricing:
Max Price: $10.00/hour
# One auto reserved node can have multiple VMs
# VMs are created when market price <= max price
💿 Virtual Machines Status Start/End
──────────────────────────────────────────────────────────────────────
vm_47xHVvU6dewFvMXNJZJ9M Destroyed 2025-08-05 15:41 → 18:00
vm_9imnBqbLvpJWToxmnYCJs Destroyed 2025-08-04 19:04 → 14:00
🎯 Actions:
Logs: sf vms logs vm_47xHVvU6dewFvMXNJZJ9M
SSH: sf vms ssh root@vm_47xHVvU6dewFvMXNJZJ9M
If you'd like to stop renewing an auto reserved node, you can release it.
# Release an auto reserved node
sf nodes release cuda-crunch