> ## 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.

# Network Configuration

> This guide covers configuring wired networking in dweOS

<Note>
  dweOS no longer supports Wi-Fi. Networking is configured entirely through
  wired Ethernet interfaces and NetworkManager connection profiles.
</Note>

<Warning>
  Modifying the network configuration includes risks. If you misconfigure the network, you may be unable to reconnect to your device without recovery.
</Warning>

## Accessing the Page

Navigate to `Network` in the sidebar.

<Frame>
  <img src="https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-networking.png?fit=max&auto=format&n=IqcFrKs4qwLx7BjO&q=85&s=6219ef08d08318d2824fed643dd2888b" alt="dweOS networking homepage view" width="3838" height="1820" data-path="dwe-os/pages/images/dwe-os-networking.png" />
</Frame>

The page has two sections:

<CardGroup cols={2}>
  <Card title="Wired Configuration">
    Shows every detected Ethernet interface, its state, and the connection
    profiles available to it.
  </Card>

  <Card title="Wireless Network">
    WiFi is not currently supported by dweOS. If you require WiFi support, [please submit an issue](https://github.com/DeepWaterExploration/dweOS/issues).
  </Card>
</CardGroup>

## Core Concepts

dweOS manages networking through NetworkManager:

* **Interface**: a physical wired port (e.g. `eth0`)
* **Connection Profile**: a saved network configuration that can be attached to a compatible interface. An interface can have
  several profiles available to it, but only one can be **active** at a time. By default, units shipped with dweOS preinstalled will only have one available profile (**Wired connection 1**).

This means changing your network setup is a two-step process: **edit** a
profile's settings, then **activate** that profile on the interface (or
reboot, which reapplies the active profile).

## Interface List

Each interface appears as a collapsible section showing its name and current
state:

| State                                                           | Meaning                                                       |
| --------------------------------------------------------------- | ------------------------------------------------------------- |
| `UNAVAILABLE`                                                   | Interface exists but has no link (e.g. unplugged)             |
| `DISCONNECTED`                                                  | Link is up but no profile is currently active                 |
| `PREPARE` / `CONFIG` / `IP_CONFIG` / `IP_CHECK` / `SECONDARIES` | Transitional states while a profile is being applied          |
| `ACTIVATED`                                                     | A profile is active and the interface has an IP configuration |
| `DEACTIVATING`                                                  | The active profile is being torn down                         |
| `FAILED`                                                        | Activation failed                                             |

<Note>
  Because it is required to connect over the network to view dweOS, you may get disconnected after network configuration. This means outputs will be less verbose than usual.
</Note>

## Connection Profiles

Underneath each interface is the list of connection profiles compatible with
it. The active profile is highlighted and shows a checkmark, along with its
live network info:

* **IPv4 Address**: the address(es) currently assigned, with prefix (e.g.
  `192.168.2.2/24`)
* **Default Route**: the gateway currently in use, if this profile is set to
  provide the default route
* **DNS**: the DNS servers currently in use

<Tip>
  Click any profile in the list to activate it on that interface.
</Tip>

## Editing a Profile

Click the gear icon on a profile to open its editor.

<Steps>
  <Step title="Choose the IPv4 method">
    * **Automatic (DHCP)**: the interface requests an address from a DHCP
      server.
    * **Manual (Static IP)**: you provide the address, gateway, and DNS
      yourself.
  </Step>

  <Step title="Configure static settings (Manual only)">
    <Frame>
      <img src="https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-networking-static.png?fit=max&auto=format&n=IqcFrKs4qwLx7BjO&q=85&s=60749ba54909e661cc6382768fffff12" width="50%" alt="dweOS static networking configuration dialog" data-path="dwe-os/pages/images/dwe-os-networking-static.png" />
    </Frame>

    When Manual is selected, additional fields appear:

    * **IP Addresses**: a table of address/prefix pairs. Use the **Add IP
      Address** button to add another entry, or the trash icon to remove one.
    * **DNS Servers**: a comma-separated list (e.g. `8.8.8.8, 1.1.1.1`)
    * **Gateway**: the gateway IP for this profile
  </Step>

  <Step title="Set routing preference">
    The **Use for Internet (Default Route)** checkbox controls whether this
    profile is allowed to provide the system's default route. Leave this checked if you are unsure.
  </Step>

  <Step title="Apply Changes">
    <Frame caption="Click anywhere inside the profile to activate it.">
      <img src="https://mintcdn.com/deepwaterexplorationinc/IqcFrKs4qwLx7BjO/dwe-os/pages/images/dwe-os-activate-connection.png?fit=max&auto=format&n=IqcFrKs4qwLx7BjO&q=85&s=e843fb1b29d51e05ac3d0b714539bbec" alt="dweOS connection profile activation" width="1533" height="456" data-path="dwe-os/pages/images/dwe-os-activate-connection.png" />
    </Frame>

    Saving writes the new configuration to the profile.

    <Note>
      Saving does **not** immediately apply the change to a live interface.
      To apply it, select the profile in the interface's list (this
      re-activates it), or reboot the system.
    </Note>

    Upon activation, you will need to manually navigate to the new IP address you specified and/or reconfigure your topside networking setup.
  </Step>
</Steps>