OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
network medium occasional DISPUTE

Make a USB or built-in LTE modem show up in NetworkManager

omarchyarchendeavouroscachyosmanjaronetworkmanagerlaptopwwan
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

Cause holds. networkmanager lists modemmanager: cellular network support as optional, quattro install/omarchy-base.packages has neither modemmanager nor usb_modeswitch and neither is installed here, and the Arch wiki NetworkManager page says to install both, enable ModemManager.service and possibly restart NetworkManager. mobile-broadband-provider-info is already a dependency of networkmanager, so it is harmless under --needed. Two parts of the fix were wrong or vague. mmcli -i 0 assumes the SIM index is 0, while the Mobile broadband modem wiki says to read it from primary sim path in mmcli -m. The FCC-unlock line named no command. The wiki and the modemmanager 1.24.2 file list show scripts under /usr/share/ModemManager/fcc-unlock.available.d/ that must be symlinked into /etc/ModemManager/fcc-unlock.d. Fix rewritten with both. Not exercised: no modem here.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

Restarting NetworkManager drops every active connection for a few seconds.

Symptom

A laptop with a built-in WWAN card (Quectel, Fibocom, Sierra) or a USB LTE stick has a SIM in it, but there is no mobile broadband option anywhere. nmcli device shows no gsm device, or shows cdc-wdm0 / wwan0 as unmanaged. mmcli -L prints bash: mmcli: command not found, or No modems were found.

Cause

NetworkManager does not drive cellular modems itself. It delegates to ModemManager, which is an optional dependency (modemmanager: cellular network support). Omarchy 4 does not install modemmanager or usb_modeswitch. Many USB sticks first enumerate as a virtual CD-ROM and need usb_modeswitch to flip into modem mode. Plain Arch has the same gap unless the user installed both.

Fix

Install ModemManager, the mode switcher and the APN database, then enable the daemon:


sudo pacman -S --needed modemmanager usb_modeswitch mobile-broadband-provider-info
sudo systemctl enable --now ModemManager.service
sudo systemctl restart NetworkManager.service    # so it picks up ModemManager

Re-plug a USB modem, then check that ModemManager sees it:


mmcli -L
mmcli -m 0          # state, signal, and "primary sim path: /org/freedesktop/ModemManager1/SIM/<n>"

If the SIM has a PIN, use the SIM number from that path, not the modem number:


mmcli -i <n> --pin=1234

Create and bring up a NetworkManager profile with your carrier's APN:


nmcli connection add type gsm ifname '*' con-name mobile apn internet.example
nmcli connection up mobile

If mmcli -L still lists nothing, check journalctl -u ModemManager -b for not supported by any plugin.

Many laptop M.2 modems (Lenovo, Dell, HP) are FCC-locked and stay offline until an unlock script runs. ModemManager ships the scripts but does not use them until you link the one for your card. Find the card's vendor and product ID, then link the matching script:


lspci -nn | grep -iE 'wwan|modem|wireless'     # ID in brackets at the end, e.g. [1eac:1001]
ls /usr/share/ModemManager/fcc-unlock.available.d/
sudo ln -sft /etc/ModemManager/fcc-unlock.d /usr/share/ModemManager/fcc-unlock.available.d/1eac:1001
sudo systemctl restart ModemManager.service

Replace 1eac:1001 (a Quectel EM120) with your card's ID. If there is no script for it, ModemManager has no unlock procedure for that card.

Verify

mmcli -L lists /org/freedesktop/ModemManager1/Modem/0. nmcli device shows a gsm device as connected after nmcli connection up mobile. ip addr shows an address on wwan0.

Sources

lte-modem-not-detected-modemmanager-missing