MS-S1 MAX Linux Networking Guide

Step-by-step guide to enabling WiFi and installing the Realtek RTL8127 10GbE driver on Ubuntu Server 24.04.

The MS-S1 MAX Mini PC includes a MediaTek MT7925 WiFi adapter and Realtek RTL8127 10GbE Ethernet ports.

Currently, the RTL8127 controller is not included in the default Linux kernel, so the 10GbE Ethernet interfaces may not be available immediately after installing Ubuntu Server 24.04.

However, the MT7925 WiFi adapter works out of the box, allowing the system to connect to the internet and download the required driver.

This guide explains how to:

• • Connect to WiFi on Ubuntu Server
• • Install the RTL8127 10GbE driver
• • Enable wired networking
• • (Optional) Configure Thunderbolt networking

All steps in this guide were verified on real MS-S1 MAX hardware running Ubuntu Server 24.04.

Test Environment

Item	Configuration
Device	MS-S1 MAX (MT7925 WiFi + RTL8127 10GbE)
System	Ubuntu Server 24.04 LTS
Kernel	Linux kernel 6.8 or newer
Wireless	MediaTek MT7925 (driver included)
Wired NIC	Realtek RTL8127 10GbE (driver required)
Network tool	netplan

Typical workflow: WiFi → install dependencies → install RTL8127 driver

WiFi Setup (Ubuntu Server / Minimal Install)

If WiFi was not configured during installation, follow the steps below to connect the system to a wireless network.

1. Verify that the MT7925 WiFi adapter is detected

Run:

«» Bash  
ip link show

You should see a wireless interface similar to:

2: wlp195s0: <BROADCAST,MULTICAST> ...

Note that wlp195s0 is only an example interface name. Use the actual interface name reported on your system.

You can also confirm that the driver module is loaded:

«» Bash  
lsmod | grep mt7925

Example output:

mt7925e  
mt7925_common  
mt792x_lib

If these modules are present, the WiFi driver is loaded correctly.

2. Configure WiFi using netplan

Edit the netplan configuration file:

~/ Bash
sudo nano /etc/netplan/01-wifi.yaml

Write the following configuration:

(Note: YAML indentation must use 2 spaces.)

network:
  version: 2
  renderer: networkd
  wifis:
    wlp195s0:
      dhcp4: true
      access-points:
        "Your WiFi SSID":
          password: "Your WiFi password"
      optional: true

Replace the following values with your actual information:

• • Your WiFi SSID
• • Your WiFi password
• • wlp195s0 (if your interface name is different)

Save and exit:

Ctrl + X

Then confirm saving the file.

Set file permissions:

«» Bash  
sudo chmod 600 /etc/netplan/01-wifi.yaml

This prevents security warnings when applying the configuration.

Apply the configuration:

«» Bash  
sudo netplan apply

After applying the configuration, wait a few seconds and the WiFi connection should be established automatically.

3. Check the WiFi IP address

«» Bash
ip addr show wlp195s0

Example output:

inet [your_ip]/23 scope global dynamic wlp195s0

Test internet connectivity:

«» Bash
ping -c 3 8.8.8.8
ping -c 3 www.baidu.com

RTL8127 10GbE Driver Installation

The Realtek RTL8127 controller is not currently included in the default Linux kernel, so the driver must be installed manually.

1. Connect to the internet

You can connect to the internet using WiFi or a USB Ethernet adapter.

a. Connect via WiFi

Use the system status bar to scan for available WiFi networks and connect to your wireless network. The process is similar to connecting to WiFi in Windows.

b. Connect via USB Ethernet adapter

After plugging in a USB Ethernet adapter, the system should automatically obtain an IP address and establish a network connection.

2. Download the driver package

Download the latest driver package:

https://github.com/minisforum-repo/r8127-dkms/releases

Download the latest r8127-dkms_xxx.deb file.

3. Install the driver

Make sure you have a working internet connection, as the installation requires downloading dependency packages.

For users in China, it is recommended to switch to the Tsinghua mirror source first.

(>) Bash  
sudo apt update

</> Bash
sudo apt install ./r8127-dkms_xxx.deb

4. Reboot the system

After rebooting, the system should detect two 10GbE Ethernet ports.

Once a network cable is connected, the ports will automatically obtain an IP address and connect to the network.

For systems without a desktop environment, such as Ubuntu Server or a minimal Linux installation, network connectivity must be configured manually — this applies to both WiFi and USB Ethernet adapters.

1. Configure WiFi using netplan

Use the nano editor to modify the netplan configuration file:

~/ Bash
sudo nano /etc/netplan/99-wifi.yaml

Write the following configuration:

(Note: YAML indentation must use 2 spaces.)

network:
  version: 2
  wifis:
    wlp195s0:
      dhcp4: true
      access-points:
        "Your WiFi SSID":
          password: "Your WiFi password"
      optional: true

2. Save and exit

Ctrl + X

Then confirm saving the file.

3. Apply configuration

sudo netplan apply

4. Verify WiFi

» Bash
ip addr show

Verify that the WiFi interface is connected and has obtained an IP address.

5. Download the driver

https://github.com/minisforum-repo/r8127-dkms/releases

6. Install the driver

» Bash
sudo apt install ./r8127-dkms_xxx.deb

7. Reboot the system

» Bash
ip addr show

You should now see two 10GbE Ethernet interfaces.

Ubuntu Server does not automatically configure these interfaces, so you will need to edit netplan to enable them.

Thunderbolt Network Bridge Configuration

There should be three configuration files in /etc/netplan.

Create a new file — name it as you prefer, for example:

30-thunderbolt.yaml

Configuration example:

network:
  version: 2
  renderer: networkd
  ethernets:
    tbt0: # interface name — modify according to your actual situation
      addresses:
        - 192.168.188.1/24

Check configuration syntax:

`Bash`
sudo netplan generate

Apply configuration:

~/ Bash  
sudo netplan apply

Conclusion

After completing the steps in this guide, the MS-S1 MAX system should have full network functionality under Linux.

The system will support:

• • MT7925 WiFi connectivity
• • Dual Realtek RTL8127 10GbE Ethernet ports
• • Optional Thunderbolt networking via netplan