> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edisglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install a VPS with a Cloud-Init qcow2 Image

> Deploy a cloud-init .qcow2 image to an EDIS Global VPS using Oracle Linux 8 as a worked example, with notes on user-data, SSH keys, and first-boot config.

### Step-by-step guide for deploying an OS using Cloud-Init.

In this example, we show you how to install an **Oracle Linux 8** from a .qcow2 cloud image via the KVM management panel. This guide covers the initial setup, including accessing the VPS Management Portal, selecting the appropriate .qcow2 image, and configuring the virtual machine settings. 

<Note>
  Make sure that your VPS plan has sufficient space to fit the cloud image.
</Note>

### Installing oracle Linux 8 using Cloud-Init

1. Open the VPS Management Portal and navigate to the <a href="https://docs.edisglobal.com/autoinstall-reinstall-install-vps-linux-windows" target="_blank">Reinstall</a> section.
2. Download <a href="https://yum.oracle.com/templates/OracleLinux/OL8/u10/x86_64/OL8U10_x86_64-kvm-b237.qcow2" target="_blank">Oracle Linux .qcow2 </a>Cloud Image from the official <a href="https://yum.oracle.com/oracle-linux-templates.html" target="_blank">template page</a> to your computer.
3. Open the VPS Management Portal select **Reinstall OS** -> select **Custom Cloud-Init Images** (third tab).

:::

<img src="https://mintcdn.com/edisglobal-b1e34a56/Gdn_5eg5HpLnsRz5/assets/y9B0AGVAxYeSyeZVyaDis-dAQWcYTrB4QhauH4Qy2B9-20240808-121621.png?fit=max&auto=format&n=Gdn_5eg5HpLnsRz5&q=85&s=efab663c10fd7dbe4c38e22ad12d0efc" alt="Cloud-init Setup" width="417" height="839" data-path="assets/y9B0AGVAxYeSyeZVyaDis-dAQWcYTrB4QhauH4Qy2B9-20240808-121621.png" />

1. Upload the .qcow2 image to your VPS, click to button "Browse"&#x20;
2. Select the previously downloaded .qcow2 file from your computer
3. Indicate a secure password
4. Tag checkbox that "Uploading a qcow2 file erases all data on your VPS!"

<Warning>
  It is important to understand that **all data on your VPS will be wiped during
  this process!**
</Warning>

<img src="https://mintcdn.com/edisglobal-b1e34a56/Gdn_5eg5HpLnsRz5/assets/y9B0AGVAxYeSyeZVyaDis-CuF_QvIFjt7M_5iCgQ_O8-20240808-122136.png?fit=max&auto=format&n=Gdn_5eg5HpLnsRz5&q=85&s=4d954a66ed0797a1b6ba76375ab985ae" alt="Cloud-init Setup" width="472" height="220" data-path="assets/y9B0AGVAxYeSyeZVyaDis-CuF_QvIFjt7M_5iCgQ_O8-20240808-122136.png" />

1. Click the "**Proceed**" button and wait until the file is fully uploaded.&#x20;
   Cloud-Init deployment will kick-in right after the upload has finished.
   Installation takes roughly 5-10 minutes.

   After the deployment is complete, you will be able to connect to the server using the password you specified during the installation process.

2. Connect to the server via SSH using default port 22&#x20;

```shell theme={"system"}
ssh root@IP_address_VPS
```

```shell theme={"system"}
#To check Oracle version use:
cat /etc/oracle-release
```

Congratulations. You installed Oracle Linux with Cloud-init. Well done