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

# Netzwerkkonfiguration

> Dieser Leitfaden behandelt die Konfiguration kabelgebundener Netzwerkverbindungen in dweOS.

> [!NOTE]
>
> dweOS unterstützt kein WLAN mehr. Das Netzwerk wird ausschließlich über
> kabelgebundene Ethernet-Schnittstellen und NetworkManager-Verbindungsprofile konfiguriert.

> [!WARNING]
>
> Das Ändern der Netzwerkkonfiguration ist mit Risiken verbunden. Wenn Sie das Netzwerk falsch konfigurieren, können Sie möglicherweise ohne Wiederherstellungsmaßnahmen keine Verbindung mehr zu Ihrem Gerät herstellen.

## Zugriff auf die Seite

Navigieren Sie in der Seitenleiste zu `Network`.

![dweOS networking homepage view](https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-networking.png?fit=max\&auto=format\&n=IqcFrKs4qwLx7BjO\&q=85\&s=6219ef08d08318d2824fed643dd2888b)

Die Seite besteht aus zwei Bereichen:

> **Wired Configuration**
>
> Zeigt jede erkannte Ethernet-Schnittstelle, deren Status und die für sie
> verfügbaren Verbindungsprofile an.

> **Wireless Network**
>
> WLAN wird von dweOS derzeit nicht unterstützt. Wenn Sie WLAN-Unterstützung benötigen, [reichen Sie bitte ein Issue ein](https://github.com/DeepWaterExploration/dweOS/issues).

## Grundkonzepte

dweOS verwaltet das Netzwerk über NetworkManager:

* **Schnittstelle**: ein physischer kabelgebundener Anschluss (z. B. `eth0`)
* **Verbindungsprofil**: eine gespeicherte Netzwerkkonfiguration, die einer kompatiblen Schnittstelle zugeordnet werden kann. Eine Schnittstelle kann
  mehrere verfügbare Profile haben, aber nur eines kann zu einem Zeitpunkt **aktiv** sein. Standardmäßig ist auf Geräten, die mit vorinstalliertem dweOS ausgeliefert werden, nur ein verfügbares Profil vorhanden (**Wired connection 1**).

Das bedeutet, dass das Ändern Ihrer Netzwerkeinrichtung ein zweistufiger Prozess ist: **bearbeiten** Sie die
Einstellungen eines Profils und **aktivieren** Sie dann dieses Profil auf der Schnittstelle (oder
starten Sie neu, wodurch das aktive Profil erneut angewendet wird).

## Schnittstellenliste

Jede Schnittstelle erscheint als ausklappbarer Abschnitt, der ihren Namen und ihren aktuellen
Status zeigt:

| Status | Bedeutung |
| - | - |
| `UNAVAILABLE` | Schnittstelle existiert, hat aber keine Verbindung (z. B. nicht eingesteckt) |
| `DISCONNECTED` | Verbindung ist aktiv, aber derzeit ist kein Profil aktiv |
| `PREPARE` / `CONFIG` / `IP_CONFIG` / `IP_CHECK` / `SECONDARIES` | Übergangszustände, während ein Profil angewendet wird |
| `ACTIVATED` | Ein Profil ist aktiv und die Schnittstelle hat eine IP-Konfiguration |
| `DEACTIVATING` | Das aktive Profil wird abgebaut |
| `FAILED` | Aktivierung fehlgeschlagen |

> [!NOTE]
>
> Da für die Anzeige von dweOS eine Netzwerkverbindung erforderlich ist, kann es sein, dass Sie nach einer Netzwerkkonfiguration getrennt werden. Das bedeutet, dass Ausgaben weniger ausführlich als üblich sind.

## Verbindungsprofile

Unter jeder Schnittstelle befindet sich die Liste der mit ihr kompatiblen Verbindungsprofile. Das aktive Profil ist hervorgehoben und mit einem Häkchen versehen, zusammen mit seinen
aktuellen Netzwerkinformationen:

* **IPv4 Address**: die derzeit zugewiesene(n) Adresse(n), mit Präfix (z. B.
  `192.168.2.2/24`)
* **Default Route**: das derzeit verwendete Gateway, wenn dieses Profil so konfiguriert ist,
  dass es die Standardroute bereitstellt
* **DNS**: die derzeit verwendeten DNS-Server

> [!TIP]
>
> Klicken Sie in der Liste auf ein beliebiges Profil, um es auf dieser Schnittstelle zu aktivieren.

## Bearbeiten eines Profils

Klicken Sie auf das Zahnradsymbol eines Profils, um dessen Editor zu öffnen.

**1. IPv4-Methode wählen**

* **Automatic (DHCP)**: Die Schnittstelle fordert eine Adresse von einem DHCP-
  Server an.
* **Manual (Static IP)**: Sie geben Adresse, Gateway und DNS
  selbst an.

**2. Statische Einstellungen konfigurieren (nur Manual)**

![dweOS static networking configuration dialog](https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-networking-static.png?fit=max\&auto=format\&n=IqcFrKs4qwLx7BjO\&q=85\&s=60749ba54909e661cc6382768fffff12)

Wenn Manual ausgewählt ist, erscheinen zusätzliche Felder:

* **IP Addresses**: eine Tabelle mit Adress-/Präfix-Paaren. Verwenden Sie die Schaltfläche **Add IP
  Address**, um einen weiteren Eintrag hinzuzufügen, oder das Papierkorbsymbol, um einen zu entfernen.
* **DNS Servers**: eine kommaseparierte Liste (z. B. `8.8.8.8, 1.1.1.1`)
* **Gateway**: die Gateway-IP für dieses Profil

**3. Routing-Präferenz festlegen**

Das Kontrollkästchen **Use for Internet (Default Route)** steuert, ob dieses
Profil die Standardroute des Systems bereitstellen darf. Lassen Sie diese Option aktiviert, wenn Sie unsicher sind.

**4. Änderungen anwenden**

![dweOS connection profile activation](https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-activate-connection.png?fit=max\&auto=format\&n=IqcFrKs4qwLx7BjO\&q=85\&s=e843fb1b29d51e05ac3d0b714539bbec)

Beim Speichern wird die neue Konfiguration in das Profil geschrieben.

> [!NOTE]
>
> Das Speichern **wendet** die Änderung **nicht** sofort auf eine aktive Schnittstelle an.
> Um sie anzuwenden, wählen Sie das Profil in der Liste der Schnittstelle aus (dies
> aktiviert es erneut) oder starten Sie das System neu.

Nach der Aktivierung müssen Sie manuell zur neuen von Ihnen angegebenen IP-Adresse navigieren und/oder Ihre Topside-Netzwerkeinrichtung neu konfigurieren.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.