easyroam-linux

Setup eduroam with easyroam on Fedora Atomic Desktops. Forked from: https://github.com/jahtz/easyroam-linux

Motivation (see original motivation)

German universities (as of the time of writing) are switching from the official eduroam client to easyroam by DFN in october 2024. Since I needed to set up Wi-Fi on my Fedora Silverblue notebook, I tried to follow their guide but quickly realized that they only officially provide a .deb client for Debian-based distributions and porting the file with alien did not work.

I stumbled upon this repository from jahtz that simplified the official guide significantly. Because I'm on Fedora Atomic, I would have to layer the openssl with rpm-ostree to be able to use the Fedora script. Since I don't want to layer any packages on top of the base image, I decided to use toolbox. Thus I had to use both scripts, easyroam_cert.sh for openssl and modified easyroam_nm.sh for nmcli.

I've only tested my setup on Fedora Silverblue 40 with NetworkManager.

If you are using a "regular" linux distribution with a package manager, please consider using the original script from jahtz!

Usage

Get certificate

1. Open https://www.easyroam.de
2. Search your university and log in.
3. Go to Generate profile.
4. Select manual options, select PKCS12 and enter your device name.
5. Download the file by clicking on the Generate profile-Button.

Install toolbox container (needed for openssl)

1. If you don't have a toolbox container created:

   toolbox create
   

   and type 'y' to confirm installation
2. To enter, type:

   toolbox enter
   

   To exit, type:

   toolbox exit
   

Fedora Atomic Desktop (e.g. Silverblue) with NetworkManger

1. Download the certificate script:

   curl -o easyroam_cert.sh https://raw.githubusercontent.com/C-3PK/easyroam-linux/main/easyroam_cert.sh
   

2. Make it executable:

   chmod +x easyroam_cert.sh
   

3. Run setup (INSIDE toolbox-container):

   ./easyroam_cert.sh
   

4. Save your Identity!
5. Download the NetworkManager script:

   curl -o easyroam_nm.sh https://raw.githubusercontent.com/C-3PK/easyroam-linux/main/easyroam_nm.sh
   

6. Make it executable:

    chmod +x easyroam_nm.sh
   

7. Run setup (OUTSIDE toolbox-container):

   ./easyroam_nm.sh
   

8. If you want to delete the generated config remove /etc/NetworkManager/system-connections/easyroam.nmconnection or run:

   nmcli connection delete easyroam
   

Original Apache 2.0 Licence