Skip to content

Saved images

Set an instance up once, save it as an image, and start new instances from it with everything already installed. This page covers which instances can be saved, how to save and deploy from an image in the dashboard, what images cost, and the API.

What an image holds

An image is a copy of an instance's boot disk: the operating system, installed packages, drivers, Python environments, downloaded models and files.

These are not part of an image:

  • Attached volumes. They stay separate and attach to any instance in their region.
  • Local scratch disks, such as the ephemeral NVMe on some Spheron AI machines.

Where it works

ProviderSave whileSpot instancesDeploy from an image
Spheron AI (most machines)Running. The provider shuts the instance down while it saves the disk and starts it again afterwards.Cannot be savedSame provider and region
Spheron ESStopped. Stop the instance first.Can be savedSame provider and region

Other providers, and some Spheron AI machines, do not offer images. The dashboard shows Save as image and the Boot from card only where they work. Through the API, check extras.capabilities.images on an offer and instanceFeatures.images on a deployment.

Save an instance as an image

  1. Open Instances.
  2. Open the instance's menu and choose Save as image.
  3. Enter a name: 1 to 60 lowercase letters, digits, hyphens or underscores, unique in your team.
  4. Check the estimated storage price, then choose Save image.

The image appears on the Images page as Saving, and turns Ready when the provider finishes. Saving takes a few minutes. Save your work before saving a running Spheron AI instance, since it restarts during the save.

Your balance must cover at least one day of the image's storage to start a save.

Deploy from an image

  1. Open Deploy GPUs or Deploy CPU and pick an offer on the image's provider and in its region.
  2. Choose Next to reach the SSH Key step.
  3. In the Boot from card, pick Saved image: <name>.
  4. Finish the deployment as usual.

The new instance runs the image's operating system, whatever was selected on the first step. The Boot from card shows only when the offer supports images and your team has a ready image in that region.

You can also choose Deploy next to a ready image on the Images page, which opens Deploy with that image picked once you choose a matching offer.

The Images page

Images, under Manage in the sidebar, lists your team's images grouped by provider and region. Each row shows the image's name, where it came from, its status, its stored size and its storage cost per month.

From a row you can deploy a ready image, or delete an image from the row's menu.

Pricing

An image bills per GB of its stored size, by the hour, from the moment saving starts until you delete it.

ProviderStorage price
Spheron AIAbout $0.075 per GB per month
Spheron ESAbout $0.09 per GB per month

The save dialog shows the estimate for the instance before you save. It is based on the disk size, and the stored size is often smaller: a fresh 100 GB disk may store as 15 GB. The stored size, and so the final price, is known once saving finishes.

Deleting an image stops its billing at once. Instances already deployed from it keep running and are not affected. See Billing for how storage charges appear.

Use images with AI connections

Assistants connected through AI connections can list your images, check the price of saving an instance, save an instance, delete an image, and deploy from a ready image.

Use the API

The images endpoints work with a GPU VM API key. See Images in the API reference.

# 1. Check the price of saving a deployment
curl https://app.spheron.ai/api/images/pricing/<deployment-id> \
  -H "Authorization: Bearer <your-api-key>"
 
# 2. Save it
curl -X POST https://app.spheron.ai/api/images \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{ "deploymentId": "<deployment-id>", "name": "trained-base" }'
 
# 3. Poll until status is "ready"
curl https://app.spheron.ai/api/images/<image-id> \
  -H "Authorization: Bearer <your-api-key>"

To deploy from the image, send its imageId on POST /api/deployments with an offer on the same provider and in the same region.

What's next

Troubleshooting

Issue: Save as image is missing from the menu

Symptoms: The instance menu has no Save as image item. Diagnosis: The instance is on a provider without images, or it is a spot instance on the Spheron AI provider. Resolution: Deploy on a dedicated Spheron AI offer or on Spheron ES, set it up, then save it.

Issue: Save as image says to stop the instance first

Symptoms: The dialog asks you to stop the instance. Diagnosis: Spheron ES saves images only from a stopped instance. Resolution: Stop the instance from its menu, wait until it shows Stopped, then save it.

Issue: The image shows Failed

Symptoms: The Images page shows Failed with a reason under the name. Diagnosis: The provider could not save the disk. A failed image bills nothing. Resolution: Delete it and save the instance again. If it fails again, contact support with the reason shown.

Issue: The Boot from card does not appear

Symptoms: The SSH Key step has no Boot from card. Diagnosis: The offer is on a different provider or region than your images, or no image is ready yet. Resolution: Pick an offer on the image's provider and in its region, and wait until the image shows Ready.