This article explains how to launch a new instance on DreamCompute within your panel.
As of July 2020, the following images are available:
Launching an instance
- Navigate to the DreamCompute page and log into your DreamCompute dashboard.
- On the top left, click the 'Compute' tab.
- From the expanded list, click 'Instances'.
The dashboard shows any existing instances with their information.
- Click the 'Launch Instance' button on the top right.
- A 'Launch Instance' pop-up box displays.
- In the 'Launch Instance' box, click through several tabs to specify which kind of instance you wish to create.
Details tab — general information
- Instance Name
Assign a name to the virtual machine.
The name you assign becomes the initial host name of the server. If the name is longer than 63 characters, the Compute service truncates it automatically to ensure dnsmasq works correctly.
If you change the host name directly after the server is built, the name is not updated in the dashboard.
Server names are not guaranteed to be unique when created so it's possible that two instances with the same host name can exist.
- Availability Zone
Currently the only zone in which DreamCompute instances can be launched is iad-2 which is located in DreamHost's Ashburn, Virginia, USA data center.
- To launch multiple instances, enter a value greater than the default value of 1.
Source tab — using the template to create your instance
- Select Boot Source (dropdown)
- There are four options for boot source:
- Instance Snapshot
- Volume Snapshot
- Image — (select to create a new Instance)
- This option allows you to:
- 1. Create a 'New Volume' with this new Instance. This option determines whether your instance uses an 80 GB ephemeral boot disk or a volume boot disk of whatever size you choose. If you select the 'YES' option, two additional fields become available.
- Volume Size (GB)
- This determines the size of your volume boot disk.
- Delete Volume on Instance Delete
- This determines whether or not the volume boot disk is deleted when you delete the instance. The recommended default of "No" allows you to delete the instance and use the existing volume as the boot source of a new instance.
- Volume Size (GB)
- 2. Choose the 'Volume Size'.
- 3. Choose if you'd like to delete the volume when you delete the Instance.
- Create a new Volume Snapshot from a list and specify if the new volume should be deleted when the instance is deleted.
- A list of Images appears at the bottom that you can create your new Instance from. For example, Debian, Fedora, Ubuntu, CentOS, and so on. Click the symbol to the right to add it.
- Instance snapshot
- Select this option if you have an existing 'Instance Snapshot' and would like to create a new Instance from it. If you choose to 'Create New Volume', make sure to also:
- Enter a 'Volume Size' that matches the size of your 'Instance Snapshot'.
- Choose if you'd like the volume deleted when you delete the instance.
- If you choose this option, a new field for Volume displays. You can select the volume from the list.
- Volume Snapshot
Flavor tab — assigning vCPU and RAM resources to your instance
- Specify the size of the instance to launch. Click the symbol to the right to add it.
The 'Total Disk' value of 80 GB is only applicable if you do not create a new volume.
You can change the flavor of an instance after launching it to increase or decrease the resources available to the instance. For more information, see the following article:
Networks tab — how your instance connects to the Internet
- If you have enabled 'Private Networking', you must specify which network you want the instance to be associated with. If you have not enabled private networking, your instance uses the public network by default and this tab can be ignored.
Security Groups tab — which ports are open
- The default security group is automatically assigned to the instance, but if you want to remove the default security group and add other groups, you can do so by using the up and down arrow symbols.
You can change which security groups are associated with an instance after launching it to alter the network accessibility of the instance. View the following article for further details:
Key Pair tab — SSH authentication for your instance's default user
Each instance can only be assigned a single Key Pair. When you originally launch an instance you can select the Key Pair you wish to use with the new instance.
It is not possible within the DreamCompute panel to change the Key Pair assigned to an instance after the instance is created. Make sure to assign the correct Key Pair when originally creating the instance.
- If you have already created and added your public SSH key, it displays here. If not, you can choose to 'Create Key Pair' or 'Import Key Pair'. Each server you launch is accessible by SSH via key-based authentication. Once you upload your public key, you can use password-less logins with the default user for your image.
If you don't already have an SSH key, view the following article for help creating/importing one:
Launching the new instance
- When finished entering all of your settings, click the Launch Instance button on the bottom right.
If any of the tabs mentioned above still contain a * symbol next to them, the "Launch Instance" button is not clickable.
Connecting to your instance
When the instance is created, you can connect to it using your SSH Key pair. View the following article for instructions on how to connect: