NavigationContentFooter
Jump toSuggest an edit
Was this page helpful?

How to create an image from a snapshot

Reviewed on 19 May 2025 • Published on 05 August 2021

Before you startLink to this anchor

To complete the actions presented below, you must have:

  • A Scaleway account logged into theconsole
  • Owner status orIAM permissions allowing you to perform actions in the intended Organization
  • AnInstance
  • At least onesnapshot

Creating an image from a snapshot via the Scaleway consoleLink to this anchor

  1. Click CPU & GPU Instances in the Compute section of the side menu. TheInstances pagedisplays.
  2. Click the Images tab. A list of your images displays.
  3. Click + Create image. The image creation page displays.
  4. Choose the Availability Zone in which you want your image to be created.
  5. Enter a name for your image and select the image architecture.
    Note

    Your image’s name can only contain alphanumeric characters and dashes.

  6. Select the snapshot from which you want to create your image in the drop-down box.
  7. Click Create image to create your image.
Tip

You can also create an image from the Snapshots dasard by clicking «See more Icon»next to the snapshot from which you want to create an image. Click Image from snapshot. A new tab opens: enter a name for your image. Then click Create image from snapshot.

Creating an image via the Scaleway CLILink to this anchor

You can also create an image using the

Scaleway CLI. Use the following command:

scw instance image create snapshot-id="$SCW_VOLUME_ID_1" additional-volumes.0.id="$SCW_VOLUME_ID_2" arch="x86_64"
  • Replace $SCW_VOLUME_ID_1 with the ID of the snapshot or volume you want to use as the root volume.
  • Replace $SCW_VOLUME_ID_2 with the ID of any additional volume to be included.
  • Ensure the architecture (arch) is set to a valid value (e.g., x86_64).
Note

Supported arguments for the image create commmand include:

ARGS:
[name=<generated>] Name of the image
snapshot-id UUID of the snapshot that will be used as root volume in the image
arch Architecture of the image (unknown_arch | x86_64 | arm | arm64)
[additional-volumes.{index}.id] UUID of the snapshot to add
[additional-volumes.{index}.name] Name of the additional snapshot
[additional-volumes.{index}.size] Size of the additional snapshot
[additional-volumes.{index}.volume-type] Underlying volume type of the additional snapshot (l_ssd | b_ssd | unified | scratch | sbs_volume | sbs_snapshot)
[additional-volumes.{index}.project-id] Project ID that own the additional snapshot
[project-id] Project ID to use. If none is passed the default project ID will be used
[tags.{index}] Tags of the image
[public] True to create a public image
[organization-id] Organization ID to use. If none is passed the default organization ID will be used
[zone=fr-par-1] Zone to target. If none is passed will use default zone from the config (fr-par-1 | fr-par-2 | fr-par-3 | nl-ams-1 | nl-ams-2 | nl-ams-3 | pl-waw-1 | pl-waw-2 | pl-waw-3)

Creating an image via the Scaleway APILink to this anchor

You can also create an image using the

Scaleway API. Use the following curl command:

curl --location "https://api.scaleway.com/instance/v1/zones/$SCW_AVAILABILITY_ZONE/images" \
--header "Content-Type: application/json" \
--header "X-Auth-Token: $SCW_SECRET_KEY" \
--data '{
"root_volume": "'$SCW_VOLUME_ID_1'",
"arch": "x86_64",
"name": "image_name",
"extra_volumes": {
"1": {"id":"'$SCW_VOLUME_ID_2'"}
},
"project": "'$SCW_PROJECT_ID'"
}'
  • Replace $SCW_VOLUME_ID_1 with the ID of the snapshot or volume to use as the root volume.
  • Replace $SCW_VOLUME_ID_2 with the ID of any additional volume.
  • Use $SCW_PROJECT_ID for the ID of your project.
  • Ensure the architecture (arch) is set to a valid value (e.g., x86_64).
Tip

Supported volume IDs include:

  • Local Storage volumes (l_ssd)
  • Block Storage Low Latency volumes (sbs)
  • Block Storage legacy (b_ssd) volumes (deprecated).
See also
How to use placement groupsHow to migrate volumes and snapshots to Scaleway SBS
Was this page helpful?
API DocsScaleway consoleDedibox consoleScaleway LearningScaleway.comPricingBlogCareers
© 2023-2025 – Scaleway