> 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/plan-and-deploy/de/referenzarchitekturen/homelab.md).

# VergeOS-Homelab-Referenzarchitektur

Referenzarchitektur für die Bereitstellung von VergeOS in Homelab-Umgebungen, einschließlich Einzelknoten-, Zwei-Knoten-Cluster- und produktionsreifer Konfigurationen mit mehrstufigem Speicher.

## Überblick

VergeOS ist eine ideale Lösung für Heimlabor-Enthusiasten und bietet eine robuste und flexible Virtualisierungsplattform. Diese Referenzarchitektur umfasst drei Konfigurationen, die sich für verschiedene Heimlabor-Setups eignen: einen VM-Host mit einem Knoten, einen Cluster mit zwei Knoten und einen Heimlabor-Cluster in Produktionsqualität mit mehrstufigem Speicher.

### Hardware-Empfehlungen

Heimlabor-Nutzer haben bei der VergeOS-Hardware eine Vielzahl von Optionen. Viele entscheiden sich aufgrund ihrer Zuverlässigkeit und Erweiterbarkeit für Enterprise-Server älterer Generation (z. B. Dell, HP, Supermicro).

Kompakte Geräte wie Intel NUCs oder ähnliche Mini-PCs sind ebenfalls beliebte Optionen, insbesondere solche mit dualem 2.5GbE-Netzwerk, NVMe-Steckplätzen und 2,5”-SSD-Schächten.

**Wichtige Überlegungen:**

* **RAID-Konfiguration:** VergeOS benötigt direkten Zugriff auf die Festplatten. Wenn Sie also einen RAID-Controller verwenden, stellen Sie sicher, dass er JBOD-/IT-Modus unterstützt, oder verwenden Sie stattdessen einen HBA.
* **IPMI-Anforderungen:** Obwohl VergeOS IPMI empfiehlt, können Heimlabor-Setups oft darauf verzichten. Einige NVIDIA-GPUs oder GPU-Passthrough-Setups können jedoch den Konsolenzugriff deaktivieren, sodass IPMI für die Verwaltung dieser Konfigurationen vorteilhaft sein kann.

***

## Szenarien

### 1. VM-Host mit einem Knoten

Eine unkomplizierte Konfiguration, ideal für Testumgebungen: Ein VM-Host mit einem Knoten eignet sich für Nutzer, die VergeOS-Funktionen erkunden, mit VMs experimentieren und neue Rezepte entwickeln möchten.

{% hint style="info" %}
**Speicherüberlegung**

VergeOS' vSAN ist als N+1 konfiguriert und bietet Redundanz. Dadurch reduziert sich der verfügbare Speicher auf 50 % der Rohkapazität, weshalb der Speicherbedarf entsprechend geplant werden sollte.
{% endhint %}

**Netzwerkkonfiguration:**

Da dieses Setup keine zusätzlichen VergeOS-Knoten umfasst, verwenden Sie dasselbe Netzwerk für die Kern- und die externe Kommunikation, um die Konfiguration zu vereinfachen.

**Anwendungsfälle:**

* Hosting von Test-VMs
* Testen von VergeOS-Rezepten und -Konfigurationen
* Allgemeines Experimentieren im Heimlabor

***

### 2. Cluster mit zwei Knoten

Diese Konfiguration fügt durch die Einführung eines zweiten Servers Redundanz hinzu und stellt so die Dienstkontinuität während Neustarts und Upgrades sicher.

{% hint style="warning" %}
**Netzwerkanforderungen**

Es werden zwei Netzwerkschnittstellen pro Server benötigt, wobei die Kernnetzwerkgeschwindigkeit für optimale Leistung mindestens 2,5 Gbit/s betragen sollte. Obwohl 1 Gbit/s möglich ist, kann dies die vSAN-Leistung einschränken.
{% endhint %}

**Anwendungsfälle:**

* Ausführen von VM-Umgebungen mit erhöhter Verfügbarkeit
* Entwicklung und Tests in einer Cluster-Umgebung
* Erweiterte Speicher- und Netzwerkredundanz

***

### 3. Produktions-Cluster für zu Hause

Diese Produktionskonfiguration mit zwei Knoten eignet sich für fortgeschrittene Heimlabor-Nutzer. Sie verbessert nicht nur die Speicherkapazitäten durch mehrere Speicherstufen, sondern ermöglicht auch eine robuste Netzwerkverwaltung, NAS-Bereitstellung und GPU-Unterstützung für Heim- und Heimlabor-Umgebungen.

Dieses Setup ermöglicht es VergeOS, als leistungsstarker zentraler Hub zu dienen, der den Netzwerkverkehr verwaltet, NAS-Dienste und GPU-Ressourcen bereitstellt und einen sicheren, optimierten Zugriff im gesamten Netzwerk bietet.

**Speicherstufen:**

* **Stufe 1 (NVMe):** Schneller Speicher für VM-Workloads, die eine hohe I/O-Leistung erfordern.
* **Stufe 3 (SSD):** Mittelschneller Speicher für NAS-Nutzung, datenintensive Anwendungen oder gemeinsamen VM-Speicher.
* **Stufe 5 (HDD):** Speicher mit hoher Kapazität für NAS und Backup-Server-VMs.

**Netzwerk- und VLAN-Konfiguration:**

Verwenden Sie VergeOS als Ihren Haupt-Router und Netzwerkmanager für Ihr Labor und Ihr Heim-LAN. Dieses Setup erfordert einen VLAN-fähigen Switch, auf dem Sie Ihrem ISP-Netzwerk ein VLAN zuweisen können (z. B. VLAN 50) und Ihr LAN als Standard-VLAN oder bei Bedarf als zusätzliche VLANs konfigurieren können.

* **Externes WAN:** Verbindet sich mit dem ISP und wird als VLAN zugewiesen.
* **Extern (LAN):** Dient als Heimlabor- und privates Netzwerk und ermöglicht Geräten innerhalb des Heimnetzwerks den Zugriff auf Ressourcen innerhalb der VergeOS-Umgebung.

{% hint style="success" %}
**Installationshinweis**

Verwenden Sie während der Installation Ihr **LAN** Netzwerk als anfängliches externes Netzwerk. Sobald die Installation abgeschlossen ist, fügen Sie das WAN-Netzwerk für den Internetzugang hinzu. Detaillierte Anweisungen finden Sie im [Knowledge-Base-Artikel zum Erstellen eines externen Netzwerks](https://docs.verge.io/knowledge-base/de/networking/create-external-network.md).
{% endhint %}

**NAS-Dienst:**

Um ein robustes NAS für Ihre heimische Umgebung einzurichten, bietet VergeOS einen integrierten NAS-Dienst, der sich perfekt für die Verwaltung gemeinsam genutzter Speicherkapazitäten mit hoher Kapazität und Redundanz eignet.

Schritt-für-Schritt-Anweisungen zur Konfiguration und Bereitstellung des NAS-Dienstes finden Sie im [Produktleitfaden für den NAS-Dienst](https://docs.verge.io/run-the-platform/de/nas/nas-service.md). Zusätzliche Konfigurationsoptionen und Schritte zur Fehlerbehebung werden in der [Knowledge Base](https://docs.verge.io/knowledge-base/de/storage-vsan/troubleshooting-nas-shares.md).

**GPU-Unterstützung:**

Für Nutzer, die erweiterte Grafikfunktionen benötigen, unterstützt VergeOS sowohl GPU-Passthrough als auch NVIDIA vGPU. Diese Optionen ermöglichen es virtuellen Maschinen, entweder dedizierte oder gemeinsam genutzte GPU-Ressourcen zu nutzen:

* **GPU-Passthrough:** Bietet eine direkte GPU-Verbindung zu einer VM für leistungsstarke Anwendungen. Siehe den [Produktleitfaden für PCI Passthrough](https://docs.verge.io/run-the-platform/de/systemadministration/generic-pci-passthrough.md).
* **NVIDIA vGPU:** Ermöglicht mehreren VMs den gemeinsamen Zugriff auf die GPU und damit eine effiziente Nutzung der GPU-Ressourcen für weniger rechenintensive Aufgaben. Siehe den [Produktleitfaden für NVIDIA vGPU](https://docs.verge.io/run-the-platform/de/systemadministration/nvidia-vgpu-configuration.md).

**Anwendungsfälle:**

* Hosting von mehrstufigen VM-Umgebungen
* **Redundantes NAS-Setup mit hoher Kapazität** für zentrale, zuverlässige Dateispeicherung
* Dient als Heimnetzwerk-Router und Firewall und bietet Sicherheit sowie zentrale Verwaltung für alle verbundenen Geräte
* Leistungsstarke VM-Anwendungen mit dedizierten GPU-Ressourcen oder gemeinsam genutzter vGPU für skalierbare Grafikverarbeitung

***

## Nützliche Links

* [VM-Rezepte](https://docs.verge.io/automate-protect-and-extend/de/automatisierung/vm-recipes.md)
* [System-Snapshots](https://docs.verge.io/automate-protect-and-extend/de/sicherung-und-dr/system-snapshots.md)
* [Bevorzugte vSAN-Stufen](https://docs.verge.io/run-the-platform/de/speicher/preferred-tiers.md)
* [VPN](https://docs.verge.io/run-the-platform/de/vpn/vpn-overview.md)
* [Netzwerkübersicht](https://docs.verge.io/run-the-platform/de/netzwerk/network-overview.md)
* [Lizenzierung](https://docs.verge.io/run-the-platform/de/systemadministration/licensing-and-updates.md)

Jede dieser Konfigurationen lässt sich an spezifische Heimlabor-Anforderungen anpassen und bietet Flexibilität auf Basis der verfügbaren Hardware und der jeweiligen Anwendungsfälle.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.verge.io/plan-and-deploy/de/referenzarchitekturen/homelab.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
