Skip to main content
This guide walks you through launching your first GPU node on SF Compute.

​
Install the CLI

curl -fsSL https://cli.sfcompute.com | bash

​
Log in

sf login
This opens your browser to authenticate and stores your credentials locally. You can check your credit balance anytime with sf billing balance.

​
Check availability

See which zones have GPUs available. 
sf zones ls

NAME             REGION  HARDWARE  NODES NOW  NEXT 48H
richmond         EMEA    H100             10  ▄▄▅▆▆▆▆▆▆▆▇█████████
marina           NA      H100              0  ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁
...
NODES NOW shows how many nodes are available to buy right now. Pick a zone with availability — in this guide we’ll use richmond.

​
Create an empty capacity

A capacity tracks your compute allocation over time. You buy compute time into a capacity with orders, and nodes on the capacity run when there’s allocated time. 
sf capacities create --zone richmond --name dev

​
Buy compute time

This will charge your account. Make sure you have credits — check with sf billing balance or top up on the dashboard.
Place a buy order for compute time on your capacity. The command will guide you through each option interactively, including number of nodes, start time, duration, and rate: 
sf orders create --capacity dev --side buy

​
Check your order

sf orders ls

SIDE  STATUS  PERIOD   NODES  RATE
Buy   Filled  Mar 23       1  ≤$20.00/node/hr
If the order shows Cancelled, the price was too low or there was no availability. Try a higher price, or check sf zones ls to buy compute for a future time when more nodes are available.

​
List images

Images are bootable OS disk images (e.g. Ubuntu + CUDA). You’ll need an image ID to create a node. 
sf images ls

│ NAME        ubuntu-22.04.5-cuda-12.7
│ ID          image_TQiHEBzCA18ToAQqBtOr_
│ VISIBILITY  public
└ STATUS      completed

​
Create a node

First, create a startup script that injects your SSH key so you can connect to the node: 
cat >startup.sh <<SCRIPT
#!/bin/bash
mkdir -p /root/.ssh
echo "$(cat ~/.ssh/id_ed25519.pub)" >> /root/.ssh/authorized_keys
SCRIPT
Then create a node on your capacity with the Ubuntu + CUDA image: 
sf nodes create --capacity dev --image {image_id} --cloud-init ./startup.sh
Your capacity already has compute time from the order you placed. Since the order’s start time was now, the node will be allocated within about a minute and begin booting. Compute ownership and nodes are separate: you can terminate and recreate nodes without losing your purchased compute time.

​
Watch your node start

sf nodes ls
The image download and boot process takes up to 10 minutes before SSH is available.

​
Connect via SSH

sf nodes ssh {node-id}
Verify the GPUs are available: 
nvidia-smi

​
Next steps

You now have a running GPU node. Here are some things to try: Sell back unused compute. Place a sell order as a standing order — if someone buys it, you get credits back and the node loses its compute time. 
sf orders create --capacity dev --side sell --nodes 1 \
  --start now --duration 1h --min-rate 8.00 --allow-standing
Check your capacity’s allocation schedule to see the compute time you own. 
sf capacities get dev
Learn more:
  • Capacities — manage compute allocation
  • Orders — buy and sell compute time
  • Nodes — SSH, logs, images, and lifecycle