> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/knowledge-base/de/virtual-machines/vm-advanced-options.md).

# Erweiterte VM-Optionen

## Überblick

Das Feld „VM Advanced Options“ ermöglicht es Power-Usern, virtuelle Maschinenparameter über das hinaus fein abzustimmen, was in der Standardoberfläche verfügbar ist. Diese Optionen bieten eine granulare Kontrolle über CPU-Funktionen, Hardwareemulation und Geräteverhalten.

{% hint style="warning" %}
**Mit Vorsicht verwenden**

Erweiterte Optionen können die Leistung und Stabilität der VM erheblich beeinflussen. Ändern Sie diese Einstellungen nur, wenn Sie ihre Auswirkungen verstehen. Falsche Werte können verhindern, dass Ihre VM startet.
{% endhint %}

## Format

Erweiterte Optionen verwenden ein einfaches Schlüssel-Wert-Format, mit einer Option pro Zeile:

```
option1=value1
option2=value2
option3=value3
```

## Verfügbare Optionen

### CPU und Speicher

#### CPU-Threads

```
cpu.threads=2
```

Legt die Anzahl der CPU-Threads pro Kern fest. Standard ist 1.

**Anwendungsfall:** Aktiviert SMT (Simultaneous Multi-Threading) für Anwendungen, die von Hyperthreading profitieren.

#### Speicher-Vorbelegung

```
mem-prealloc=1
```

Belegt beim Start den gesamten VM-Speicher vor, statt ihn bei Bedarf zuzuweisen.

**Anwendungsfall:** Verringert die Latenz bei der Speicherzuweisung für leistungsentscheidende Workloads. Nützlich für Echtzeitanwendungen oder bei der Verwendung von Hugepages.

### UUID-Konfiguration

Sie können die UUID (Universally Unique Identifier) der VM anpassen, um spezifische Anforderungen zu erfüllen, z. B. für Softwarelizenzierung oder Migrationsszenarien.

#### System-UUID

```
smbios.type1.uuid=550e8400-e29b-41d4-a716-446655440000
```

Legt die dem Gastbetriebssystem präsentierte System-UUID fest. Dies ist die primäre UUID, die die meisten Programme prüfen.

**Anwendungsfälle:**

* VMs von anderen Plattformen migrieren und dabei die Lizenzierung beibehalten
* Software, die gegen eine bestimmte UUID validiert
* VMs klonen, die eindeutige Kennungen benötigen

{% hint style="warning" %}
**UUID-Format**

UUIDs müssen im Standardformat vorliegen: `xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` (8-4-4-4-12 hexadezimale Zeichen). Ungültige Formate verhindern den Start der VM.
{% endhint %}

{% hint style="success" %}
**UUIDs generieren**

Unter Linux: `uuidgen` Unter Windows PowerShell: `[guid]::NewGuid()` Online: Verwenden Sie ein beliebiges UUID-Generator-Tool
{% endhint %}

### SMBIOS-Anpassung

SMBIOS-Optionen (System Management BIOS) ermöglichen es Ihnen, die dem Gastbetriebssystem präsentierten Hardwareinformationen anzupassen.

#### Typ 0 - BIOS-Informationen

```
smbios.type0.vendor=American Megatrends Inc.
smbios.type0.version=2.0
smbios.type0.date=01/01/2023
```

#### Typ 1 - Systeminformationen

```
smbios.type1.product=Custom Server
smbios.type1.version=1.0
smbios.type1.sku=SKU123
smbios.type1.family=Server Family
```

#### Typ 2 - Hauptplatineninformationen

```
smbios.type2.manufacturer=Custom Manufacturer
smbios.type2.product=Custom Board
smbios.type2.version=1.0
```

#### Typ 3 - Gehäuseinformationen

```
smbios.type3.manufacturer=Custom Chassis
smbios.type3.version=1.0
smbios.type3.sku=CHASSIS123
```

#### Typ 4 - Prozessorinformationen

```
smbios.type4.version=Intel(R) Xeon(R) CPU E5-2680 v4
smbios.type4.manufacturer=Intel
```

**Anwendungsfälle für SMBIOS:**

* Softwarelizenzierung, die Hardware-Signaturen prüft
* Anwendungen, die bestimmte Hardwarekonfigurationen erwarten
* Testszenarien, die eine bestimmte Systemidentifikation erfordern

### Feinabstimmung der Netzwerkschnittstelle

Für jede NIC können Sie Warteschlangenparameter mithilfe der Asset-ID der NIC anpassen:

```
nic1.txqueuelen=2000
nic1.numtxqueues=4
nic1.numrxqueues=4
```

**Anwendungsfälle:**

* Netzwerkanwendungen mit hohem Durchsatz
* Reduzierung der Netzwerklatenz
* Optimierung für spezifische Netzwerk-Workloads

### Maschinenspezifische Parameter

QEMU-Maschinenparameter anpassen:

```
machine.cap-cfpc=broken
machine.cap-sbbc=broken
machine.cap-ibs=broken
```

**Anwendungsfälle:**

* Umgehung von Problemen mit CPU-Sicherheitsminderungen
* Kompatibilität mit bestimmten Gastbetriebssystemen
* Leistungsoptimierung für vertrauenswürdige Umgebungen

### RTC-Optionen (Echtzeituhr)

```
rtc.drift-fix=slew
```

**Anwendungsfälle:**

* Behebung von Zeitdrift-Problemen in VMs
* Synchronisationsanforderungen für zeitkritische Anwendungen

## Gerätespezifische Optionen

Sie können Parameter für jedes Gerät anhand seiner Asset-ID festlegen:

```
device1.guest-reset=true
device1.guest-resets-all=false
```

Für Laufwerke:

```
drive1.cache=writeback
drive1.detect-zeroes=on
```

## Häufige Anwendungsfälle

### Hochleistungsrechnen

```
cpu.threads=2
mem-prealloc=1
nic1.numtxqueues=8
nic1.numrxqueues=8
```

### Windows-Lizenzkonformität

```
smbios.type1.manufacturer=Dell Inc.
smbios.type1.product=PowerEdge R740
smbios.type1.serial=ABC123
```

### UUID nach der Migration beibehalten

```
smbios.type1.uuid=550e8400-e29b-41d4-a716-446655440000
```

Verwenden Sie dies, wenn Sie eine VM von einer anderen Plattform migrieren und das Gastbetriebssystem Software enthält, die an die ursprüngliche UUID gebunden ist.

### Netzwerkoptimierung

```
nic1.txqueuelen=5000
nic1.numtxqueues=4
nic1.numrxqueues=4
```

## Bewährte Verfahren

{% hint style="success" %}
**Empfehlungen zum Testen**

1. Testen Sie erweiterte Optionen zuerst in einer Nicht-Produktionsumgebung
2. Dokumentieren Sie alle von Ihnen verwendeten erweiterten Optionen für die spätere Bezugnahme
3. Fügen Sie nur Optionen hinzu, die bestimmte Probleme oder Anforderungen lösen
4. Überwachen Sie die VM-Leistung nach dem Anwenden erweiterter Optionen
   {% endhint %}

## Fehlerbehebung

Wenn Ihre VM nach dem Hinzufügen erweiterter Optionen nicht startet:

1. Entfernen Sie alle erweiterten Optionen und versuchen Sie, die VM zu starten
2. Fügen Sie die Optionen nacheinander wieder hinzu, um die problematische Einstellung zu identifizieren
3. Überprüfen Sie die VM-Protokolle auf bestimmte Fehlermeldungen
4. Überprüfen Sie die Syntax – stellen Sie sicher, dass jede Option in einer eigenen Zeile ohne zusätzliche Leerzeichen steht

{% hint style="info" %}
**Versionskompatibilität**

Einige erweiterte Optionen sind möglicherweise nicht in allen VergeOS-Versionen verfügbar. Optionen werden dynamisch verarbeitet, sodass nicht unterstützte Optionen normalerweise ignoriert werden, anstatt Fehler zu verursachen.
{% endhint %}

{% hint style="info" %}
**Dokumentinformationen**

* Zuletzt aktualisiert: 2026-01-24
* VergeOS-Version: 26.1
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.verge.io/knowledge-base/de/virtual-machines/vm-advanced-options.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
