Network configuration

Network configuration

MocaccinoOS uses Network Manager to manage network connections by default. It handles wired and wireless connections automatically and can be controlled via the nmcli command line tool, a graphical applet in your desktop environment, or the nmtui text interface.

For users who prefer a more minimal setup, systemd-networkd is also available as an alternative.

Network Manager

Checking status

To verify Network Manager is running and connected:

1

nmcli general status

To list all network interfaces and their state:

1

nmcli device status

To list all configured connection profiles:

1

nmcli connection show

Wi-Fi

Scan for available networks:

1

nmcli device wifi list

Connect to a network:

1

nmcli device wifi connect <SSID> password <password>

Disconnect from Wi-Fi:

1

nmcli device disconnect <interface>

To enable or disable Wi-Fi:

1
2

nmcli radio wifi on
nmcli radio wifi off

Wired (Ethernet)

Wired connections are configured automatically via DHCP when a cable is plugged in. If you need to set a static IP address on a connection, see the Static IP section below.

To bring a wired connection up or down manually:

1
2

nmcli connection up <connection-name>
nmcli connection down <connection-name>

Static IP

To assign a static IP address to an existing connection:

1

nmcli connection modify <connection-name> ipv4.method manual ipv4.addresses 192.168.1.50/24 ipv4.gateway 192.168.1.1 ipv4.dns 192.168.1.1

Then bring the connection back up to apply the changes:

1

nmcli connection up <connection-name>

To revert back to DHCP:

1
2

nmcli connection modify <connection-name> ipv4.method auto
nmcli connection up <connection-name>

nmtui

If you prefer a simple text-based interface over the command line, Network Manager includes nmtui. Launch it with:

1

nmtui

This opens a menu-driven interface where you can add, edit, and activate connections without needing to remember nmcli syntax.

systemd-networkd

If you prefer to use systemd-networkd instead of Network Manager, follow the steps below.

1. Switch services

Disable Network Manager and enable systemd-networkd:

1
2
3

systemctl stop NetworkManager
systemctl disable NetworkManager
systemctl enable --now systemd-networkd

Then enable systemd-resolved for DNS resolution:

1

systemctl enable --now systemd-resolved

2. Find your interface name

Run networkctl to list available network interfaces:

1

networkctl

Example output:

IDX LINK    TYPE     OPERATIONAL SETUP
  1 lo      loopback carrier     unmanaged
  2 enp3s0  ether    routable    configured
  3 enp2s0  ether    off         unmanaged

Note the name of the interface you want to configure (e.g. enp3s0).

3. Configure your interface

Create a configuration file for your interface:

1

nano /etc/systemd/network/00-enp3s0.network

Static IP:

1
2
3
4
5
6
7

[Match]
Name=enp3s0

[Network]
Address=192.168.1.50/24
Gateway=192.168.1.1
DNS=192.168.1.1

DHCP:

1
2
3
4
5

[Match]
Name=enp3s0

[Network]
DHCP=yes

After saving the file, restart the service to apply your changes:

1

systemctl restart systemd-networkd