Eduroam installation on Linux

Fictitious Eduroam logo

This morning it took me an hour to get Eduroam working. Eduroam is the international WLAN roaming service for university students and staff. I brought in my (non-university managed) laptop to work and tried to get connected. I finally found the instructions on the IT Helpdesk site on place place 19 (from 21 results shown on the first page when searching for "Eduroam Linux"): https://helpdesk.it.helsinki.fi/en/instructions/logging-and-connections/...
As usual, the instructions are from many years back and no longer work on a "recent" system such as Ubuntu 20.04 LTS. On top of this, I had some old, dysfunctional Eduroam settings lingering around from a previous failed attempt. For the instructions below, you will need the Eduroam configuration tool, which you can download from https://cat.eduroam.org. To make it work, I had to do the following things:

  1. If necessary, modify the installer script to make it run at all (you need to change the first line of the installer script, changing "python" into "python3". This seems not to be necessary anymore with recent versions of the Eduroam installer, as it was updated sometime between 2022 and 2024.
  2. Delete my pre-existing configuration by going to WiFi settings > Eduroam > Forget
  3. Remove the directory ~/.cat_installer
  4. If you had multiple failed attempts, it might also be a good idea to restart your networking (or simply reboot your computer after doing the above additional steps).
  5. The username is given in the format username@ad.helsinki.fi. I do not know whether this is necessary, but it worked as of September 2024 on Ubuntu 22.04.5
  6. It is not necessary (even counterproductive) to execute the script as root. At least, that is the case for Ubuntu 22.04 and higher.

When I encounter outdated or wrong information on the IT Helpdesk site, I occasionally respond to the offer "How would you improve these instructions?" by giving feedback, hoping to save others some time. However, during the last 5 years, I have never received any other answer except something like the following:

We have processed your support request "Feedback form for the Helpdesk instructions portal".
Actions:
Sadly, we have very limited resources. We are constantly improving the Helpdesk site, but adding instructions for this case exceeds our possibilities.