Connect to eduroam wifi on Linux

These instructions have been tested on Ubuntu 20.04 and 22.04. The screen layouts, settings and steps might be different for other versions of Ubuntu and alternative Linux.

These instructions make use of a python script provided via the eduroam Configuration Assistant Tool (CAT) website. Information about how the script works is available during the download process. The script works with Python 3 (in testing it did not work with Python 2.x). If these instructions do not work for you then you should use the generic settings to make your connection.

Before you begin, make sure you are in a location where the eduroam wireless network is available.

Connect to eduroam using the CAT installer on Linux

1. Make sure your Linux device is online. You can connect via UniOfCam-Guest or a wired connection.

2. Create a new network access token for your Linux device. You need to create a separate token for each of your devices. Use a meaningful username such as CRSid+laptop@cam.ac.uk or similar. You will need to include the '+' symbol when you create your username and use lower case. Keep the window with the new network access token open as you will need this later.

   Create a new network access token on the Networks Access Tokens website.

3. Download the eduroam CAT installer:

    

   

    

    

   

    

   • In a web browser, go to cat.eduroam.org (opens a new browser window).
   • Select the 'download your eduroam installer' button.
   • A pop-up window will appear listing nearby profiles, check that 'United Kingdom' is selected next to 'Show organisations in' at the bottom of this window.
   • If 'University of Cambridge' is not listed then search for it using the search box at the bottom of the list.
   • Select 'University of Cambridge'.
   • Select the 'Download your eduroam installer Linux' and choose 'Save File'. You will need to know where this file has been saved to (this will depend on your browser settings). If you would like more information about how the script works select the 'i' box.

4. Run the installer to configure your connection

    

   

    

    

   

    

    

   

    

   • Open a terminal window ('ctrl-alt-t' should work on most platforms).
   • Go to the directory that the installer was downloaded to (for example, 'cd ~/Downloads').
   • The installer requires dbus-python to be installed, which itself requires libpython3-dev & libdbus-1-dev
   • You can do this either in a virtual environment:

         - mkdir -p ~/.virtualenvs
         - python3 -m venv ~/.virtualenvs/eduroam-installer
         - source ~/.virtualenvs/eduroam-installer/bin/activate
         - sudo apt-get install build-essential libpython3-dev libdbus-1-dev
         - python3 -m pip install dbus-python
         - or Fedora/RHEL users should be able to use "sudo dnf install dbus-devel" (untested)
      

   • ...or system-wide, install the relevant operating system package using your
     package manager.
   • Once dbus-python is installed run the eduroam installer by typing 'python3 eduroam-linux-UoC-eduroam_local_CA.py'.
   • An information pop-up should appear, select 'OK'.
   • Select 'Yes' to continue past the next window (''This installer will only work properly if you are a member of University of Cambridge and the user group: eduroam").
   • You will now be prompted to enter your username. Enter the username for the network access token you created for this device in step 2. It should be in the format CRSid+device@cam.ac.uk, for example, abc123+myworkpc@cam.ac.uk. Select 'OK'.
   • Now enter the password for the network access token you created for this device. Some browsers can add extra spaces when you copy and paste so if your password isn't working, try typing it instead.
   • You will be asked to re-enter your password. Once you have done this, select 'OK'.
   • You should see the message 'Installation successful'. Select 'OK'.

5. Check that you connected to eduroam. Your method of doing this will vary according to your version of Linux and desktop. On Ubuntu 18.04, you should be able to do the following:

    

   

    

    

   

   • Click 'Activities' (top left of your screen).

   • Select the 'Settings' icon.

      

     .

      

   • Choose 'Wi-Fi' from the top of the list on the left.

   • If 'Wi-Fi' is currently turned off, turn it on using the slider at the top of this window.

   • You should see a list of available wireless networks:

   • If eduroam does not have a tick next to it, then select it to connect. 
   • Check your connection by clicking the settings 'gear wheel' icon next to eduroam in the list.

6. Finally, make sure you forget the UniOfCam-Guest network so that you always connect to eduroam in the future:

   1. Open the Activities overview and start typing "Wi-Fi".

   2. Find the 'UniOfCam-Guest' network and select the cog button next to it. 

   3. Select 'Forget Connection'.

Get help

If you're still unable to connect, please look through our troubleshooting guide or contact the Service Desk: servicedesk@uis.cam.ac.uk.