NOTE: This tutorial will be much easier to follow if you first secure your wireless network and write down the SSID and Passphrase to a piece of paper glued to the underside of the router.

Ubuntu with GNOME desktop

(includes Ubuntu Netbook Remix)

1. Click on the wireless networking icon: (If you don't have an icon that looks like that, you probably don't have a compatible wireless adapter.)
2. A menu that looks like the following will pop up:

1. If you see your network in the list of Wireless Networks (such as Gator), you can click it, otherwise click on Connect to Other Wireless Network... and a dialog like the following will pop up:

1. If you clicked on your network in the previous step, skip this one, otherwise enter the name of your network in Network Name. The Network Name is better known as the SSID.
2. The value of Wireless Security will depend on how the wireless network was secured but WPA Personal is usually what's used unless there are some older wireless devices on the network.
3. All that's left is to enter the wireless network's passphrase or password (it might be easier if you click the Show password checkbox first) and finally click Connect.
4. Once the connection succeeds, you might be prompted to enter or create a password for the default keyring.
   • If you have saved passwords before, enter the master password. It is separate from your account's password and can be different.
   • If you don't remember the master password, you will need to delete your default keyring if you want the password to be remembered.
   • If you asked to choose a password, this will protect all the passwords remembered by the built-in password manager with a single, master password. If you ever let other people borrow your computer without using another account, you should enter a password here, otherwise you can just leave it empty and click OK.

OLPC XO

Note: Follow these instructions if you are unable to use the built-in Network Manager-based UI in the neighbourhood. I have found this to be the case when attempting to connect to a WPA-protected access point. Sources of inspiration:

• http://www.alvarezp.org/blog/2007/12/18/howto-diagnose-connectivity-to-your-wireless-network-using-linux/
• http://wiki.laptop.org/go/Manual_Wireless_Association
• http://olpcnews.com/forum/index.php?topic=2217.0
• http://linux.die.net/man/8/wpa_supplicant
1. Start the Terminal activity.
2. Create a text file (using, say, nano) called radio.sh with the following contents:
   1. #!/bin/sh
   2. # make sure the fancy stuff isn't enabled
   3. service NetworkManager stop
   4. service network stop
   5. # make sure the manual stuff isn't in the way
   6. pkill dhclient
   7. pkill wpa_supplicant
   8. if [ "$1" ]; then
   9. echo "Connecting to $1..."
   10. MY_PATH="`dirname \"$0\"`"
   11. wpa_supplicant -B -i eth0 -c $MY_PATH/$1
   12. dhclient eth0
   13. else
   14. echo "Turning off radio..."
   15. fi
3. Before we connect to a network for the first time, we need to create a configuration file. We do this by running the following command from within your home directory, replacing both instances of SSID with the SSID of the network you are connecting to (i.e. Gator):
   1. wpa_passphrase SSID > SSID
   2. # reading passphrase from stdin
   3. I am one with the universe
   4. network={
   5. ssid="Gator"
   6. #psk="I am one with the universe"
   7. psk=a14b11ec75a1a374b28fc4ee0e1f2e1571ba28fb4acc672e92cb7b1b18d80d80
   8. }