NAME

wifi — configure wired and wireless networking on MOUSE

DESCRIPTION

MOUSE uses wpa_supplicant(8) to associate and authenticate a wireless interface. dhcpcd(8) then obtains addresses, routes, and DNS configuration.

Network configuration is machine-wide and administrator-managed. MOUSE does not provide per-user wireless profiles or a graphical network manager.

WIRELESS CONFIGURATION

Perform the following steps as root, or prefix the administrative commands with doas(1).

1. Find the wireless interface with dmesg(8) and ifconfig -a. The interface name is hardware-dependent; iwm0 is only an example.
2. Set that interface in /etc/conf.d/wpa_supplicant:

   wpa_interface="iwm0"

3. Add a network block to /etc/wpa_supplicant.conf:

   network={
   	ssid="example"
   	psk="password"
   }

   This file contains network credentials and must remain readable only by root.

4. Set wpa_supplicant_enable to YES in /etc/rc.conf to start the service at future boots. The DHCP network service is enabled by default.
5. Start wireless authentication, then renew network configuration:

   rc-service wpa_supplicant start
   rc-service network restart

   After changing either configuration file, restart both services in that order.

VERIFICATION

Check service state with:

rc-service wpa_supplicant status
rc-service network status
ifconfig iwm0

Replace iwm0 with the configured interface. If no wireless interface appears, the adapter needs NetBSD driver and firmware support before this configuration can work.

WIRED NETWORKING

The network service runs dhcpcd(8) and is enabled by default. An ordinary wired DHCP connection therefore needs no wireless configuration. For a static address, route, VLAN, bridge, or other specialised setup, see ifconfig(8) and route(8).

SEE ALSO

doas(1), rc.conf(5), mouse(7), world(7), dhcpcd(8), dmesg(8), ifconfig(8), rc-service(8), route(8), wpa_supplicant(8)