Guides - Deploy an Image to an Existing Compute Instance

Note

Pricing change: On September 1, 2021, Custom Images transitioned to a paid service with a cost of $0.10/GB per month for each Custom Image stored on an account. Recovery Images, generated automatically after a Compute Instance is deleted, will continue to be provided at no cost. See Images > Pricing for additional details.

While it’s typically more common to deploy an Image to a new Compute Instance, you are also able to deploy an Image to an existing Instance. You may wish to do this if you want to maintain consistent billing or if you wish to add the Image alongside the existing data.

There are two methods to deploy an Image to an existing Compute Instance:

• Rebuilding the Compute Instance
• Adding a disk to the Compute Instance

Deploy an Image by Rebuilding a Compute Instance

A common method of deploying an Image is to rebuild an existing Compute Instance with your desired Image. This deletes all data and disks on that Instance and creates new disks for the selected Image. Use this method only if you no longer need the data that’s stored on the Instance.

1. Log in to the Cloud Manager and navigate to the Images page.

2. Locate the Image you wish to deploy and click the corresponding ellipsis options menu. Select Rebuild an Existing Linode.

3. Within the Restore from Image panel that appears, select the Compute Instance to use and click the Restore Image button.

   

4. You are redirected to the dashboard page for that Linode and the Rebuild form is displayed with the chosen Image preselected. Complete the remainder of this form, making sure to select your desired Root Password, and any other options that may be needed. See Rescue and Rebuild → Rebuilding for full instructions on rebuilding a Linode.

5. Click the Rebuild Linode button to rebuild the Linode. All existing disks will be deleted and a new disk will be created using the selected Image.

Deploy an Image by Adding a Disk to a Compute Instance

If you instead wish to retain the data on your Compute Instance, you can add a disk with your desired Image to that Instance. This is useful if you wish to have multiple bootable configurations and only need to access one at a time.

1. Log in to the Cloud Manager, click the Linodes link in the sidebar, and select a Compute Instance from the list.

2. Create a disk with the Image. Follow the instructions to create a disk using the Cloud Manager. Keep the following considerations in mind:

   • Confirm there is enough unallocated storage space to accommodate the new disk for the desired Image. If you aren’t sure of the size of the Image, open the Images page, find the Image within the list, and view the Size column.
   • When creating the disk, select the Create from Image option and select the Image you wish to deploy.

3. Optionally create a swap disk. Your image may require a swap disk in order to boot. If you already have a swap disk on your Compute Instance from a previous image deployment (visible under the Disks panel), you can reuse that same disk with your new image. Otherwise, you can create a new swap disk:

   1. Navigate back to the Linode’s Storage tab and click the Add a Disk button.

   2. In the Add Disk form, select Create Empty Disk and choose the swap option from the Filesystem dropdown menu. Then enter a Label and Size (usually 128MB, 256MB, or 512MB). Click the Add button to create the disk.

4. Create or edit a configuration profile. To boot using the new disk, the disk needs to be properly assigned within a new or existing configuration profile and selected as the Root Device.

   1. Navigate to the Linode’s Configuration tab and click the Add Configuration button. It’s also possible to adjust an existing configuration profile by clicking the Edit link next to that configuration.

   2. Within the Add (or Edit) Configuration form that appears, assign the disk under Block Device Assignment and select that device as the Root Device. Here are the important fields within this form:

      Field	Value
      Label	A name for the configuration profile.
      Comments	Enter any comments that may help you remember the purpose for your new configuration profile, or any other notes you’d like to record.
      Select a Kernel	In most cases, select GRUB 2.
      /dev/sda	Choose the disk for the new Image that was just deployed.
      /dev/sdb	Choose the swap disk, if one is available.

      For all of Linode’s standard distribution images, the other fields can retain their default values. For Custom Images, you may need to update other parts of the configuration profile. Review the Managing Configuration Profiles on a Linode and Install a Custom Distribution on a Linode guides for further guidance.

5. Reboot the Compute Instance using the new Image. Navigate to the Configuration tab, find the new configuration profile in the list, and click the corresponding Boot link. This link may be displayed with the More Options ellipsis dropdown menu.

For help with configuring the software on your new disk, review the Getting Started and Setting Up and Securing a Compute Instance guides.