I just want my WiFi working!

The chapter about wireless networking in the FreeBSD Handbook is a wonderful source of information. Sometimes, however, bits go crazy and you simply cannot diagnose a simple networking issue. Don't be afraid to ask the community if you're stuck. System configuration in a console happens to be intimidating to newcomers.

  • Read the chapter related to wireless networking in the FreeBSD Handbook. It should be enough to set up a wireless connection on a FreeBSD machine.


  • It might be a good idea to check out Laptops. Maybe someone with a similar machine described how to set up a wireless device.

ifconfig doesn't show my wireless card

You're probably looking for sysctl -n net.wlan.devices.

Also, make sure you've actually read the wireless networking chapter.


My wireless card does not show up in sysctl -n net.wlan.devices

A driver might be missing. Check out the output of pciconf -lv and look for devices with the network class.


Well, here are a couple of ideas:

  • Some drivers require the user to explicitly acknowledge the firmware license. Check out the manual page of the driver you're using for details.
  • Remember to load required firmware if needed. Consult your manual.

Where is the urtwn driver? It is mentioned on many websites

It was replaced by rtwn(4).


I've got some problems with the iwm(4) driver

  • As of 2018.04.25 some people report that iwm(4) causes a kernel panic when configured via loader.conf(5).

So, although the manual says to add

if_iwm_load="YES"
iwm3160fw_load="YES"

to loader.conf(5), it is sometimes better to add the following line to rc.conf(5) instead:

kld_list="if_iwm iwm3160fw"

(Of course, this is just an example in which we assume that you need firmware for an Intel Corporation Wireless 3160 card.)

Works for phpdave11 (#freebsd, Freenode, 2018.05.09)

  • iwm(4) devices do not start automatically for some users when system boots so they add the following command to crontab(1):
@reboot ifconfig wlan0 create wlandev iwm0


How to configure Eduroam?

An example configuration has been added to the wpa_supplicant.conf(5) manual page in FreeBSD 12-CURRENT.


I am sure I put correct password into /etc/wpa_supplicant.conf but it still doesn't work

wpa_supplicant.conf(5) has a couple of syntactic subtleties, which might be causing this:

  • The value of psk should be either a "-quoted passphrase (e.g. "password") or a 256-bit pre-shared WPA key (e.g. c4c5b44ebb507f6c8b10ea42eb30521465c1cc000e432748fa9f87eb68b63cc1). Also, check out wpa_passphrase(8).

bsdconfig netdev
    • Intimidating at first, it is not actually that bad.
    • This is utility is why you put ctrl_interface=/var/run/wpa_supplicant in wpa_supplicant.conf(5).

You may seek help on the following communication channels.

See Channels for a list of all the FreeBSD IRC channels.


  • wifi/faq.txt
  • Last modified: 2023/01/29 14:06
  • by GrahamPerrin