# IONOS Private Cloud: Subscribing to the ISO content library in vSphere

This article explains how to subscribe to the ISO content library to provide the latest operating systems on your virtual machines in the private cloud. To do this, complete the following:

## Open vSphere Client

To establish a VPN connection to your IONOS Private Cloud.

1. Log in to your [<mark style="color:blue;">IONOS CLOUD account</mark>](https://dcd.ionos.com).
2. In the [<mark style="color:blue;">**Data Center Designer (DCD)**</mark>](https://docs.ionos.com/cloud/support/general-information/glossary-of-terms#data-center-designer-dcd), go to **Menu** > **Private Cloud** > **Login**.
3. Log in to the [<mark style="color:blue;">Cloud Panel</mark>](https://cloudpanel.ionos.de/login) with your credentials.
4. Make a note of the username and password that are displayed in the **Private Cloud** > **Administration** area in the **Access** > **vSphere** section.
5. To open the vSphere Client, click on **vSphere Client** in the **Private Cloud** > **Administration** area in the **Access** > **vSphere** > **Admin Client** section. A new tab opens.
6. In the new tab, click on **Advanced...**.
7. Click on **Accept risk and continue**.
8. Click on **START VSPHERE CLIENT (HTML5)**. The login page opens in a new tab.
9. Enter the user name and password.
10. Click on **LOGIN**.

## Add content library

1. In the vSphere Client, click on the menu icon with the three horizontal lines in the top left of the menu bar.

![The menu icon](/files/Ztcm9aFZvxKLr5v2CTLI)

2. Click on **Content Libraries**. The **Content Libraries** area opens.

![The Content Libraries menu option on the vSphere Client page](/files/r3mMvpZ4TPZ7zY2nENTD)

3. Click on **Create**. The **Name and location** window opens.

![The Create option is highlighted on the Content Libraries page of the vSphere Client](/files/0ZPGN42crRL7FrHngsxU)

4. Enter a name for the new library in the **Name:** field.
5. Optional: Enter a description in the **Notes:** field.
6. Click on **Next**. The **Configure content library** window opens.

![The Next button is highlighted on the Name and location window of the vSphere Client](/files/aQvUQR5RLCxX1fnJsp9Q)

7. Select the **Subscribed content library** option.
8. Enter the following address in the **Subscription URL** field: `https://pc-content.ionoscloud.tools/ISOs/lib.json`
9. In the **Download content** section, select the setting **when needed**.
10. Click on **Next**. The **Apply security policy** window opens.

![The Next button is highlighted on the Configure content library window of the vSphere Client](/files/i4T5JfBN41XgopK8DCIq)

11. Click **Next** in **Apply security policy** window. The **Add storage** window opens.
12. Select the storage in which the downloaded ISOs are to be saved.
13. Click on **Next**. The **Ready to complete** window opens.

![The Next button is highlighted on the Add storage window of the vSphere Client](/files/DvN0sgu3mVvGjF508dMw)

14. Click on **Finish**.

![The Finish button is highlighted on the Ready to complete window of the vSphere Client](/files/XRXldLV3oE9KvGF8S371)

## Create a new virtual machine using an ISO file from the content library

1. In the vSphere Client, click on the menu icon with the three horizontal lines in the top left of the menu bar.

![The menu button is highlighted on the vSphere Client page](/files/CudMHaXahHIGcjIUYsxe)

2. Click on **Inventory**.

![The Inventory menu option is highlighted on the vSphere Client page](/files/KkQNVibYoPOeYKO2IQQ7)

3. Select your vSphere cluster.
4. Click on **Actions** > **New Virtual Machine...** and follow the steps of the wizard.

![The New Virtual Machine menu option is highlighted within the Actions menu of the vSphere Client](/files/SFcz1A1dP9OuwnjSE5PJ)

5. When the **Customize Hardware** window is displayed, click on the **New CD/DVD Drive** list.
6. Select the **Content Library ISO File** option. The **Choose an ISO image to mount** window is then displayed.

![The Content Library ISO File list item is highlighted in the New CD/DVD Drive list](/files/sbnLcwSL5JvX8uorCSeG)

7. Select the desired ISO image from the list.
8. Click on **OK**. The **Customize hardware** window is displayed again.
9. Click on **Next**.
10. Click **Finish** in the **Ready to complete** window.

The new virtual machine is created.

## Troubleshooting

The creation of a VM may fail if the ISO content library is still downloading or synchronising the ISO image at the time of creation. If the creation of your VM fails, cancel the process and check whether the library is synchronised. To do this, click on Recent Tasks in the menu bar at the bottom and then on the arrow pointing upwards.

Wait until the synchronisation is displayed as completed in the task window. Then repeat the creation of the VM.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ionos.com/cloud/private-cloud/ionos-private-cloud/administration/subscribe-iso-content-library.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
