---
updatedAt: 2025-11-25T07:36:36.000Z
agentTools:
  projectIndex: https://kb.telemaxx.de/llms.txt
---

# HowTo: Eigene ISOs in der OpenCloud verwenden

## Einleitung

Die OpenCloud stellt bereits eine Auswahl an vorkonfigurierten Betriebssystem-Images bereit, die direkt für die Erstellung von Instanzen genutzt werden können. Diese Images sind vollständig integriert und enthalten alle notwendigen Image Properties, um eine reibungslose Bereitstellung und automatische Erkennung im System zu gewährleisten.

In manchen Fällen kann es jedoch erforderlich sein, eigene ISO-Dateien zu verwenden – beispielsweise für angepasste Linux-Distributionen oder spezielle Windows-Installationen. Solche benutzerdefinierten ISOs können über die OpenStack CLI oder über das Horizon-Dashboard in die OpenCloud hochgeladen werden.

Damit diese selbst hochgeladenen Images ebenfalls korrekt in der Plattform erkannt und verarbeitet werden, müssen die entsprechenden Metadata-Properties manuell gesetzt werden. Besonders wichtig ist hierbei das Image Property `os_distro` und `os_type` das den Typ des Betriebssystems angibt:

* Für Linux-Images: os\_type=linux
* Für Windows-Images: es darf **kein** *os\_distro* und *os\_type* angegeben werden

Bestimmte Images erfordern noch weitere Image Properties, als Beispiel: soll die VM mit einem uEFI Installiert werden, muss *hw\_firmware\_type = uefi* hinzugefügt werden. Manche Image Property erfordern eine Kombination wie `hw_firmware_type=uefi` und `hw_machine_type=q35` diese müssten zwingend zusammen konfiguriert werden.

Eine vollständige Liste finden Sie hier: <https://docs.openstack.org/glance/latest/admin/useful-image-properties.html>

***

## Linux Images

Für Linux Images sind folgende Image Properties empfohlen - Beispiel für Linux Ubuntu:

* os\_type = linux
* os\_distro = ubuntu
* hw\_qemu\_guest\_agent = yes
* hw\_firmware\_type = uefi
* hw\_machine\_type = q35

Der *os\_type = linux* sollten immer gesetzt werden. Das `os_distro` Image Property sollte entsprechend an die verwendete Distribution angepasst werden z. B. *os\_distro = debian*

## Windows Images

für Windows Images haben wir bereits einen passenden Beitrag.
Link: <https://kb.telemaxx.de/docs/windows-server-installation-mit-eigener-iso>

Windows benötigt noch ein paar weitere Image Properties die gesetzt sein müssen.

Metadata:

* hw\_disk\_bus = virtio
* hw\_firmware\_type = uefi
* hw\_machine\_type = q35
* hw\_qemu\_guest\_agent = yes
* hw\_scsi\_model = virtio-scsi

**Bei Windows sollte kein *os\_type* und kein *os\_distro* angegeben werden.**

Die OpenCloud kann für selbst hochgeladene oder angepasste Images keinen vollständigen Support oder Funktionsgarantie übernehmen. Insbesondere die erforderlichen Metadata-Properties (z. B. os\_distro, hw\_machine\_type, architecture usw.) müssen vom Benutzer eigenständig recherchiert, gepflegt und getestet werden, um eine korrekte Erkennung und Kompatibilität innerhalb der Plattform sicherzustellen.

Zur Sicherstellung eines stabilen und einheitlichen Betriebs empfiehlt es sich, nach Möglichkeit die bereitgestellten OpenCloud-Standard-Images zu verwenden. Diese sind vollständig geprüft, gepflegt und enthalten bereits alle notwendigen Metadaten.

<Callout icon="🚧" theme="warn">
  Das Einspielen und Verwenden eigener ISO-Images in der OpenCloud ist grundsätzlich möglich und bietet die Flexibilität, individuelle Betriebssysteme oder angepasste Installationen zu nutzen.
  Bitte beachten Sie jedoch, dass der Einsatz solcher Images in eigener Verantwortung erfolgt.
</Callout>

***

## CLI

Im Folgenden wird beschrieben, wie der Upload einer eigenen ISO über die CLI und Horizon erfolgt und wie die notwendigen Metadata-Properties korrekt ergänzt werden.

<Callout icon="📘" theme="info">
  **Voraussetzung:**

  Application Credentials muss erstellt worden sein [https://kb.telemaxx.de/docs/opencloud-howto-application-credentials](https://kb.telemaxx.de/docs/opencloud-howto-application-credentials)
</Callout>

### ISO hochladen

**Linux**

```shell
openstack image create "ubuntu-24.04-iso" \
  --file ubuntu-24.04.iso \
  --disk-format iso \
  --container-format bare \
  --property os_distro=ubuntu \
  --property os_type=linux \
  --property hw_qemu_guest_agent=yes
```

**Windows**

```shell
openstack image create "windows-server-2022-iso" \
  --file Windows_Server_2022.iso \
  --disk-format iso \
  --container-format bare \
  --property hw_disk_bus=virtio \
  --property hw_firmware_type=uefi \  
  --property hw_machine_type=q35 \
  --property hw_qemu_guest_agent=yes \  
  --property hw_scsi_model=virtio-scsi \
```

### Metadaten anpassen

```shell
openstack image set ubuntu-24.04-iso --property os_distro=ubuntu
```

### Image löschen

```shell
openstack image delete ubuntu-24.04-iso
```

<br />

***

## Horizon-Dashboard

### ISO hochladen

**Beispiel von einer Linux ISO**

**ISO:**

Horizon -> Compute -> Abbilder -> Abbild erstellen

<Image border={false} src="https://files.readme.io/7838a63a334a06c4bbd90da86cd041d12fee03d42af3f72757a4bd413958d3c7-Screenshot_2025-10-21_at_08.20.14.png" />

<br />

* Abbildname: ubuntu-24.04
* Datei: ISO auswählen
* Abbildformt: ISO

<Image border={false} src="https://files.readme.io/5638915274354100deeefb45b666c7b58fdcb98c61c47c4afad2901ebe9acce6-Screenshot_2025-10-21_at_08.23.39.png" />

Schritte 4,5 und 6 sind optional und dienen der besseren Verwaltung und Umgang mit dem Image.

### Metadata-Properties anpassen

Gewünschte Properties hinzufügen und Abbild erstellen drücken.

<Image align="center" border={false} width="600px" src="https://files.readme.io/a7400e1d9fbc03cc384faf124c07049e1edd36fbe0b09c2588f381ea8d42f0a5-Screenshot_2025-10-20_at_11.47.37.png" />

<br />

***

### Image löschen

Horizon -> Compute -> Abbilder -> Dropdown Menü -> Abbild löschen

<Image border={false} src="https://files.readme.io/ea281674686e396aca24366e02ab3fbdcee67b94027b239b6eb9afed7b476058-Screenshot_2025-10-20_at_11.58.01.png" />

<br />

***

## Image verwenden

Das Image kann nun auf zwei Arten verwendet werden. Das Image steht bei der Erstellung einer VM unter Quelle zur Verfügung oder kann direkt im Horizon-Dashboard unter *Compute -> Abbilder* gestartet werden. Über den Button "Start" kann direkt eine Instanz aus dem Abbild heraus Installiert werden.