Stud I/O Cloud Docs

Appearance

Create Basic Instance using Horizon UI ​

This document will guide you through the process of creating a basic, persistent Compute instance using the Horizon UI. This is the recommended method for "traditional" servers where you want the data to persist even if the instance is shut down.

Prerequisites ​

  • Access to your Horizon dashboard URL and credentials.
  • A project with sufficient quota.
  • At least one tenant network.

Steps ​

Track your progress. Data is saved locally in your browser.
Checklist: None

Sign in to Horizon ​

  1. Use your browser to navigate to the Stud I/O Cloud Compute Control Panel (Horizon) or use the button below:

    🌐Open Horizon↗

  2. Sign in and choose the appropriate Project.

Create a Key Pair ​

Before launching an instance, ensure you have an SSH Key Pair to access it.

  1. In the left navigation, go to Compute > Key Pairs.
  2. If you don't have one, click Create Key Pair.
  3. Enter a name (e.g., my-laptop-key) and click Create Key Pair.
  4. Important: The browser will download a .pem file. Save this safe place (e.g., ~/.ssh/)! You cannot download it again.
    • On macOS/Linux, run chmod 600 /path/to/key.pem to secure it.

Launch the Instance ​

  1. Go to Compute > Instances.
  2. Click Launch Instance.

Configure the instance ​

Work through the tabs of the Launch Instance wizard:

  • Details

    • Instance Name: Give it a name (e.g., web-server-1).

  • Source (Storage)

    • Select Boot Source: Image
    • Create New Volume: Yes (IMPORTANT: This ensures your disk is persistent).
    • Volume Size: Adjust if needed (default 10GB or image size).
    • Delete Volume on Instance Delete: No (Recommended to keep data safe) or Yes (If you want cleanup).
    • Select an Image: (e.g., Ubuntu).

  • Flavor

    • Select a size (vCPUs/RAM).

  • Networks

    • Select your tenant network.

  • Security Groups

    • Select a group that allows SSH (Port 22).

  • Key Pair

    • Select the Key Pair you created/verified in the first step.

Note: For advanced configuration like Cloud-Init scripts or Ephemeral (stateless) boot, see the Advanced Instance Guide.

Launch & Connect ​

  1. Click Launch Instance.
  2. Wait for Status to be Active.
  3. (Optional) Assign a Floating IP if you need public access.
  4. Connect via SSH:
bash
ssh -i /path/to/your-key.pem ubuntu@<IP_ADDRESS>

Troubleshooting ​

  • Cannot SSH? Check Security Groups and ensure you are using the correct .pem key file with chmod 600 permissions.
  • Instance Error? Check the "Log" tab in the instance details.

Clean up ​

To delete the instance:

  1. Actions > Delete Instance.
  2. If you selected "Delete Volume on Instance Delete: No", remember to manually clean up the Volume in Volumes > Volumes if you no longer need the data.