Ethernet¶
The Ethernet tab shows and edits the wired network configuration for a selected interface.
| Field | Notes |
|---|---|
| Interface Name | Pick the interface, if more than one is detected |
| Mode | DHCP (automatic) or Manual (static IP) |
| IP Address, Subnet, Default Gateway | Only editable in Manual mode |
| Nameservers | Comma-separated, e.g. 8.8.8.8, 1.1.1.1 |
| Automatic IPv6 | Checkbox |
Switching to a static IP¶
- Set Mode to Manual. The IP Address, Subnet, and Default Gateway fields become editable:
- Fill in IP Address, Subnet, and Default Gateway.
- Adjust Nameservers if needed.
- Click Save.
The staged change: confirm or it rolls back automatically¶
A saved Ethernet change does not apply immediately
Clicking Save does not switch the network configuration right away. Instead, Cockpit stages the change and shows a pending banner with a live countdown and two buttons: Confirm and Roll back.
- Click Confirm while you still have a working connection to the gateway, and the new configuration becomes permanent.
- Click Roll back to cancel and restore the previous configuration immediately.
- If you do neither before the countdown reaches zero, Cockpit automatically rolls back to the previous configuration.
This exists specifically so a mistyped static IP or gateway can't lock you out of the device: if the new settings actually broke connectivity, you simply won't be able to reach the page to click Confirm — and the gateway reverts itself. Always watch for the pending banner after saving an Ethernet change, and don't close the tab until you've either confirmed the change (from a working connection) or the countdown has rolled it back.
Canceling an edit in progress¶
Click Cancel on the form to discard unsaved edits and revert the displayed fields, without staging anything.