Skip to main content
This feature is in public preview.
Images are the disk templates instances boot from. SFC provides base images with common configurations. You can also upload your own custom images.

​
Image requirements

SFC supports UEFI amd64 (x86_64) raw images. We do not support qcow2. Custom images should resize themselves to the full disk size during the boot process to make use of the full disk space available to the instance. For an example of how to build an SFC compatible image with packer, see our example Github repository. All custom images must have drivers for both and for networking. All custom images must have cloud-init installed and the networking configuration step must be enabled in order for networking to be set up.

​
Image fields

Images have three key fields:
  • id — The unique identifier like image_abc123
  • name — A human-readable name like ubuntu-22.04-cuda-12.4 or training-base
  • provider — Either sfc for SFC-provided base images or custom for images you upload

​
Uploading an image

Upload a raw disk image with sf images upload. The CLI handles multipart upload with progress tracking and SHA256 integrity verification. The maximum image size is 75 GiB.
For large images, increase upload concurrency to speed things up.
If you omit --file or --name, the CLI will prompt you interactively. Custom images are scoped to your account. Run sf images list to see all images available to you, including SFC’s public images.

​
Using an image

Pass an image name or ID when creating an instance.
If you omit --image, the CLI will present an interactive picker showing all completed images available to you.

​
Revoking an image

Revoke an image to stop new instances from using it. Existing instances keep running.
The command prompts for confirmation. Pass --yes to skip it. Reinstate a revoked image to make it usable again:

​
Deleting an image