Instances (VMs)

SSH Keys

To connect to your virtual machines, you need an SSH key pair. You can either use your own keys or generate new ones via bwCloud-OS. Detailed instructions can be found here.

Launching an Instance

Create an Instance (GUI)

1. Click Instances in the left menu. On the new page, select the Launch Instance button. A dialog will open, guiding you through the process step by step.
2. First, give the instance a meaningful name (e.g., myVM01). Click Next at the bottom.
3. Select a source / Image for the instance (e.g., Debian X). Add the selection using the ↑ symbol; the chosen image will appear under Allocated. To discard a selection, click the ↓ symbol in the row.
4. In the next step, select a Flavor. If the current quota is too low, a yellow warning icon will appear.
5. Next, choose the Network. In most cases, the default settings are sufficient; no changes are required.
6. For the Security Group, no adjustments are usually necessary. Changes can be made later if needed.
7. Select the public SSH Key to be integrated into the instance. This step is mandatory; without a registered SSH key, access to the running instance is not possible.
8. Click Launch Instance. The instance will start.
9. After the instance has successfully started, the IP address will be displayed in the overview. The instance can be accessed at this address.

SSH Access

Once started, you can log in via SSH:

ssh -i /path/to/private-key <username>@<ip-address>

The corresponding SSH usernames are listed in this reference list.

Configure an Instance with Ansible

It is also possible to create an instance automatically. Details can be found here.

Quota and resources

Various resources are available in bwCloud-OS. If you need more quota, you can request it. You can find more information here.

BwCloud-OS Provided-Flavors

Resize an instance after additional quota has been granted

If your project has been allocated more quota (vCPU/RAM/instances), you can upgrade an existing VM to a larger hardware flavor. This will restart the VM and change the flavor (vCPU/RAM).

Important:

• Data on attached volumes (Cinder) will remain unchanged.
• Back up important data before performing the resize.

Prerequisites

• Sufficient quota in the selected region.
• Appropriate larger flavor available (see Hardware Flavors).
• Schedule a maintenance window (short restart / brief downtime).

Step-by-Step (Dashboard)

1. Log in to the bwCloud-OS Dashboard and select the desired region in the top left.
2. Navigate to Project → Compute → Instances.
3. Open the dropdown menu for the desired instance and select Resize Instance.
4. Select a larger flavor (e.g., from m1.small to m1.medium) and confirm with Resize.
5. Wait until the status shows VERIFY_RESIZE and the VM is reachable again.

After Resizing: Verify & Confirm

1. Check that the resources match:
   1. RAM/CPU: free -h, nproc
   2. Disk layout: lsblk, df -h
2. If everything is working: select Confirm Resize in the instance dropdown.
3. If problems occur: select Revert Resize (restores the previous flavor).

Notes

• Attached data volumes must be resized separately via Volumes → Extend Volume and then extended within the guest system (e.g., sudo resize2fs or sudo xfs_growfs).
• The VM will be restarted during the resize; the IP address remains unchanged.