Oracle Cloud Infrastructure Documentation

Launching an Instance Based on an Image

Use Marketplace to launch an instance from an image listing.

When you create an instance, several other resources are involved (for example, an image, a cloud network, or a subnet). These resources can be in the same compartment  with the instance or in other compartments. You must have the required level of access to each of the compartments involved so that you can launch the instance. This is also true when you attach a volume to an instance.
    1. Open the navigation menu and click Marketplace. Under Marketplace, click All Applications.
    2. Click the listing that you're interested in.
    3. Review the Usage instructions tab to ensure you understand what you will need to deploy and to access the instance after you launch it. Both Linux and Windows instances require a cloud network to launch the instance into. For more information, see Networking Overview. Depending on the type of instance, to access it, you might need an SSH key pair or a security list that enables Remote Desktop Protocol. For more information, see Managing Key Pairs on Linux Instances and Creating an Instance .
    4. On the pane that displays the version and compartment, perform the following steps:
      1. From the Version field, select the package version of the image that you want to install. By default, the menu displays the latest version.
      2. From the Compartment field, select the name of the compartment where you want to launch the instance. (If you don't have permissions to launch the instance in the selected compartment, it is launched in the root compartment instead.).
      3. Accept the terms and conditions by selecting the check box and click Launch Instance.
      To finish launching the instance, follow the instructions in Creating an Instance.
    Important

    Be aware of the following information about minimum-bill instances:

    • Some Marketplace images, for example, Microsoft SQL Server image cannot be resized because of minimum-bill licensing constraints. This behavior can be overridden by enabling such instances to be added to an allow-list category. If you want to resize a Microsoft SQL Server image, contact support.
    • Once you're added to an allow-list category, wait at least the number of minimum-bill hours (that is, a month) after the instance is launched before you attempt to resize a minimum-bill instance. This approach does not incur any additional costs when you resize a minimum-bill instance.
    • For more information about resizing an instance, see Changing the Shape of an Instance.

    The information you need to connect to an instance after you create it might be in the Usage Information or the Related Documents sections of the listing.

  • Open a command prompt and run oci compute instance launch to launch an instance:

    oci compute instance launch --availability-domain <availability_domain> --compartment-id <compartment_OCID> --shape <instance_shape> --subnet-id <subnet_OCID> --image-id <image_OCID>

    For example:

    oci compute instance launch --availability-domain Uocm:PHX-AD-1 --compartment-id ocid1.compartment.oc1..example1example25qrlpo4agcmothkbgqgmuz2zzum45ibplooqtabwk3zz --shape VM.Standard1.2 --subnet-id ocid1.subnet.oc1.phx.exampleahetdvobxd5cvbqfcjmw2ddryahoqrp4ot2fauxvbdeirpa2gpt2a --image-id ocid1.image.oc1.phx.exampleae44ah3b5xyet6tlvli23cvbtetyugfckfwgg6fywrkk3fauxscyq

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Use the following operations to work with listings: