Skip to content

Instantly share code, notes, and snippets.

@MoritzHauff
Created October 13, 2026 08:11
Show Gist options
  • Select an option

  • Save MoritzHauff/baa7dc9bec0d47544e4c685b9d7fbecd to your computer and use it in GitHub Desktop.

Select an option

Save MoritzHauff/baa7dc9bec0d47544e4c685b9d7fbecd to your computer and use it in GitHub Desktop.
Configuration of eduroam connection on Arch Linux using NetworkManager

Configure an eduroam Connection on Arch Linux Using NetworkManager

This is a write-up of the steps I used to configure eduroam on a brand-new Omarchy v4 installation after the automatic installers failed to work for me.

It is a slightly modified version of the instructions published by the University of Stuttgart: University of Stuttgart eduroam Configuration Guide

Caution

These instructions were created for my own eduroam account at the University of Stuttgart. They may not work for other universities, as certificate requirements and authentication settings can differ. Use them at your own risk.

If you need to configure your Wi-Fi connection manually in NetworkManager, you can follow the steps below.

Step 0

Install the Server CA certificate. My university mentioned two server CA possibilities: either Hellenic Academic and Research Institutions RootCA 2015 or HARICA TLS RSA Root CA 2021

Substep a

Become root:

sudo su

Substep b

Download HERICA CA certificate

mv /home/moritz/Downloads/HARICA-TLS-Root-2021-RSA.pem /usr/share/ca-certificates/trust-source/anchors/HARICA-TLS-Root-2021-RSA.pem

Substep c

Change permissions

chown root:root /usr/share/ca-certificates/trust-source/anchors/HARICA-TLS-Root-2021-RSA.pem
chmod 0400 /usr/share/ca-certificates/trust-source/anchors/HARICA-TLS-Root-2021-RSA.pem

Substep d

Install certificate

cat /usr/share/ca-certificates/trust-source/README
update-ca-trust

Step 1

Issue a new certificate for your device. Download as PKCS#12. Set some random password for the download (e.g. use pwgen) as you only need it once here (and once for your import on your machine).

Step 2

Become root (sudo su / su)

Step 3

Save your downloaded PKCS#12 bundle into a system location:

mv /home/moritz/Downloads/UniStuttgart_stxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.p12 \
  /etc/ssl/private/UniStuttgart_stxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.p12 

Adjust the /home/moritz/ according to your actual username.

Step 4

Secure file ownership and permissions:

chown root:root /etc/ssl/private/UniStuttgart_stxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.p12 
chmod 0400 /etc/ssl/private/UniStuttgart_stxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.p12 

Step 5

In case SELinux is enabled, register the changes as legitimate:

restorecon -r /etc/ssl/private

Step 6

Cleanup any WiFi profiles that you do not need or use (including any old eduroam):

nmcli connection
nmcli connection del eduroam

The nmcli connection list should now be either empty or only contain active entries.

Step 7

Add new eduroam connection:

nmcli connection add type wifi con-name "eduroam" ssid "eduroam"

nmcli connection modify eduroam \
  connection.autoconnect-priority 100 \
  connection.permissions "" \
  connection.metered no \
  802-1x.eap tls \
  802-1x.identity tlsclient@uni-stuttgart.de \
  802-1x.ca-cert /usr/share/ca-certificates/trust-source/anchors/HARICA-TLS-Root-2021-RSA.pem \
  802-1x.altsubject-matches DNS:eduroam.uni-stuttgart.de \
  802-1x.client-cert /etc/ssl/private/UniStuttgart_stxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.p12 \
  802-1x.private-key /etc/ssl/private/UniStuttgart_stxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.p12 \
  802-1x.private-key-password "<Your_PKCS#12_Download_Password>" \
  802-1x.private-key-password-flags 0 \
  802-11-wireless-security.key-mgmt wpa-eap

Use connection.permissions "", so that all users and especially root can access this connection (system-wide connection). Adjust the Your_PKCS#12_Download_Password according to your actual used password.

Step 8

Verify that eduroam now works for you:

nmcli connection show --active

If you need to force the connection to eduroam:

nmcli connection up eduroam

Step 9

You can check all connection settings:

nmcli connection show eduroam

In previous iterations I had problems activating the connection. It was possible to access debug messages on my specific machine with:

journalctl -xe NM_CONNECTION=63a9097c-6401-xxxx-xxxx-xxxxxxxxxxxx + NM_DEVICE=wlp2s0
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment