Skip to main content
This feature is in public preview.
This guide walks you through launching your first GPU instance on SF Compute.

Install the CLI

Log in

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

Check what you can buy

Hardware is described by instance SKUs. Preview what’s currently for sale, one row per SKU.
NEXT AVAILABLE is the soonest a node frees up and how many — now (N), a time like Today, 8:00pm (4), or when nothing’s scheduled; NEXT 48H sparklines the schedule with the peak shown to the right.

Create an empty pool

A pool tracks your compute allocation over time. You buy compute time into a pool with orders, and instances on the pool run when there’s allocated time.

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 pool. The command guides you through each option interactively, including number of instances, start time, duration, rate, and the instance SKU the order pins to.

Check your order

If the order shows cancelled, the price was too low or there was no availability. Try a higher rate, a later start time, or use --allow-standing to leave the order on the book.

List images

Images are bootable OS disk images. You’ll need an image name or ID to create an instance.
SFC provides public images with Ubuntu and CUDA pre-installed. You can also build and upload your own custom images.

Create an instance

First, create a startup script that injects your SSH key so you can connect to the instance.
Then create an instance on your pool with the public image.
Your pool already has compute time from the order you placed. Since the order’s start time was now, the instance will be allocated within about a minute and begin booting. Compute ownership and instances are separate: you can terminate and recreate instances without losing your purchased compute time.

Watch your instance start

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

Connect via SSH

Verify the GPUs are available:

Next steps

You now have a running GPU instance. 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 instance loses its compute time.
Check your pool’s allocation schedule to see the compute time you own.
Learn more:
  • Pools — manage compute allocation
  • Orders — buy and sell compute time
  • Instances — SSH, logs, images, and lifecycle